400 크레딧 무료, 카드 등록 없이지금 시작하기
Logo
무료로 시작하기
400 크레딧 무료, 카드 등록 없이

Search 데이터 API

API 한 번의 호출로 Tavily Search 데이터를 받아 가세요. Runs a web search via Tavily and returns ranked results plus an optional LLM-generated `answer` synthesised from the top sources. Set `include_answer=true` to enable answer synthesis. Use `search_depth=advanced` for higher-relevance results (also unlocks `chunks_per_source`). Filter results to specific domains via `include_domains` (comma-separated), or exclude via `exclude_domains`. Time-bounded queries via `time_range` (`d` / `w` / `m` / `y`) or explicit `start_date` / `end_date` (YYYY-MM-DD).

무료로 시작하기문서 보기

Tavily Search API, 직접 써 보세요

코드 한 줄 짜기 전에, 실제 데이터부터

GET/v1/tavily/search

The search query — natural-language free text.

선택 파라미터 14개

Latency-vs-relevance tradeoff. `basic` is the default; `advanced` unlocks `chunks_per_source` and higher-relevance ranking.

Search category. Defaults to `general`. Use `news` for time-sensitive queries and `finance` for market data.

Time window relative to now. Accepts `day` / `week` / `month` / `year` (or shorthand `d` / `w` / `m` / `y`).

Number of results to return (1–20). Defaults to 5.

Max relevant chunks returned per source (1–5). Only honoured when `search_depth=advanced`. Defaults to 3.

Include images alongside the result content.

Include AI-generated descriptions for the returned images.

Include an LLM-generated answer string synthesised from the top sources.

Include the raw HTML/text alongside the cleaned content.

Comma-separated list of domains to restrict results to (e.g. `nytimes.com,reuters.com`).

Comma-separated list of domains to exclude from results.

ISO 3166-1 alpha-2 country code to bias results toward.

Inclusive lower bound on result publish date (YYYY-MM-DD).

Inclusive upper bound on result publish date (YYYY-MM-DD).

27개 플랫폼을 한 번에 살펴봐요

·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·TikTok Shop·Amazon Shop·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Polymarket·Tavily·Hacker News·GitHub·Perplexity·UUtility·Universal Search
·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·TikTok Shop·Amazon Shop·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Polymarket·Tavily·Hacker News·GitHub·Perplexity·UUtility·Universal Search
·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·TikTok Shop·Amazon Shop·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Polymarket·Tavily·Hacker News·GitHub·Perplexity·UUtility·Universal Search
·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·TikTok Shop·Amazon Shop·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Polymarket·Tavily·Hacker News·GitHub·Perplexity·UUtility·Universal Search
Tavily API

Search API로 무엇을 할 수 있을까요

Search 엔드포인트가 통합 스키마와 계산 필드를 담은 Tavily 데이터를 한 번의 요청으로 보내드려요. 스크래핑 인프라를 직접 만들거나 유지할 필요가 없어요.

요청 예시

GET /v1/tavily/search?query=claude+opus+4.7+release+notes

파라미터

파라미터필수설명
query예The search query — natural-language free text.
search_depth아니오Latency-vs-relevance tradeoff. `basic` is the default; `advanced` unlocks `chunks_per_source` and higher-relevance ranking. (basic | advanced | fast | ultra-fast)
topic아니오Search category. Defaults to `general`. Use `news` for time-sensitive queries and `finance` for market data. (general | news | finance)
time_range아니오Time window relative to now. Accepts `day` / `week` / `month` / `year` (or shorthand `d` / `w` / `m` / `y`). (day | week | month | year | d | w | m | y)
max_results아니오Number of results to return (1–20). Defaults to 5.
chunks_per_source아니오Max relevant chunks returned per source (1–5). Only honoured when `search_depth=advanced`. Defaults to 3.
include_images아니오Include images alongside the result content.
include_image_descriptions아니오Include AI-generated descriptions for the returned images.
include_answer아니오Include an LLM-generated answer string synthesised from the top sources.
include_raw_content아니오Include the raw HTML/text alongside the cleaned content.
include_domains아니오Comma-separated list of domains to restrict results to (e.g. `nytimes.com,reuters.com`).
exclude_domains아니오Comma-separated list of domains to exclude from results.
country아니오ISO 3166-1 alpha-2 country code to bias results toward.
start_date아니오Inclusive lower bound on result publish date (YYYY-MM-DD).
end_date아니오Inclusive upper bound on result publish date (YYYY-MM-DD).
API 상세

Tavily Search API는 어떻게 동작하나요

API 키와 함께 GET 요청을 보내면, 통합 스키마와 계산 필드를 담은 깔끔한 JSON이 돌아와요.

메서드

GET

응답 형식

JSON

왜 SocialCrawl인가요

Tavily Search 데이터는 왜 SocialCrawl로 가져올까요

Tavily 데이터 추출에서 까다로운 부분은 SocialCrawl이 가려 드려요. 통합 스키마, AI 인리치먼트, 그리고 코드에 남지 않는 플랫폼 로직까지.

개발자 우선

소셜 미디어 데이터를 몇 초 만에 수집하는 방법

개발자를 위한 가장 빠른 소셜 미디어 스크래핑 API. 월간 활성 사용자 100억 명 이상을 포괄하는 27개 플랫폼에서 프로필, 게시물, 댓글, 분석 데이터를 수집하세요.

모든 플랫폼을 하나의 스키마로

동일한 응답 구조로 27개 플랫폼을 조회하세요. 연동은 한 번이면 충분합니다.

단순 수집을 넘어 계산된 필드 제공

모든 응답에 engagement_rate, estimated_reach, content_category, language가 포함되어 바로 활용할 수 있습니다.

코드 없이 사용 가능

Visual Data Explorer — URL만 붙여넣으면 결과 카드, 정형화된 테이블, CSV 내보내기 기능을 제공합니다.

import requests

response = requests.get(
    'https://www.socialcrawl.dev/v1/tiktok/profile',
    params={'handle': 'charlidamelio'},
    headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()
[ .JSON ]
{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": { "username": "charlidamelio", "followers": 124000 },
    "engagement": { "likes": 5200, "engagement_rate": 0.045 },
    "metadata": { "language": "en", "content_category": "food" }
  }
}
외 다수

Tavily Search 데이터, 가져올 준비 되셨어요?

API 키 받고 60초 안에 Tavily 데이터를 받아 가세요.

무료로 시작하기