웹 검색
1 크레딧/v1/tavily/search자연어 쿼리에 대한 순위 웹 결과를 반환합니다. include_answer로 LLM 요약을 켤 수 있습니다. depth, topic, time_range, 도메인 필터, max_results로 범위를 제어합니다.
query, search_depth, topic, time_range, max_results, include_answer, include_domains, exclude_domains
Tavily 엔드포인트
Tavily 웹 그라운딩 읽기 엔드포인트는 4개입니다. 선택적 답변이 있는 검색, 다중 URL extract, 사이트 맵, 다중 페이지 crawl을 제공합니다. 데이터 API만 지원하며 고객 앱에 두 번째 Tavily 계정은 필요 없습니다.
URL 추출
1 크레딧/v1/tavily/extractURL 1개 또는 최대 20개 CSV에서 정제 텍스트를 가져옵니다. markdown 또는 text 형식입니다. 어려운 페이지는 advanced extract depth를 사용합니다. 실패 URL은 성공과 함께 보고됩니다.
urls (CSV, max 20), extract_depth, format
사이트 맵
1 크레딧/v1/tavily/map루트에서 본문 없이 URL을 발견합니다. depth, breadth, limit, 경로·도메인 필터를 지원합니다. 커버리지만 필요할 때 crawl보다 빠릅니다.
url, depth, breadth, limit
사이트 크롤
1 크레딧/v1/tavily/crawl페이지별 추출 본문이 있는 다중 페이지 크롤입니다. 자연어 instructions로 경로 선택을 안내합니다. map과 같은 필터 계열에 extract depth와 format이 추가됩니다.
url, limit, extract_depth, format
Tavily API4개 엔드포인트 지원
문서 보기질의어로 웹을 검색해 결과를 순위대로 반환하며 요청하면 상위 출처를 엮은 서술형 답변도 함께 돌려줍니다.
도메인이나 날짜, 주제로 범위를 좁힌 검색 결과가 필요하고 짧은 답변까지 곁들이고 싶을 때 사용하세요.
GET/v1/tavily/search?query=claude+opus+4.7+release+notes
query · The search query — natural-language free text.
$ curl https://www.socialcrawl.dev/v1/tavily/search?query=claude+opus+4.7+release+notes \
-H "x-api-key: sc_YOUR_API_KEY"— · 대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다Tavily API 동작
Tavily도 다른 SocialCrawl 엔드포인트와 같습니다. API 키로 GET /v1/tavily/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다. 앱에 두 번째 Tavily 키를 두지 않고 웹 그라운딩을 씁니다.
호출 인증
x-api-key 헤더에 키를 보냅니다. 소셜 플랫폼, Universal Search, Google Trends, Tavily에 같은 키를 사용합니다.
GET과 쿼리 파라미터
네 라우트 모두 GET입니다. query, urls 또는 url과 선택 depth·필터를 전달합니다. 서버가 쿼리 문자열을 Tavily JSON 본문으로 변환한 뒤 업스트림을 호출합니다.
크레딧 과금
라이브 미스는 호출당 1 크레딧(표준 티어)입니다. 캐시 히트는 0 크레딧입니다. 빈 응답과 하드 실패는 환불됩니다. 잘못된 파라미터는 400이며 과금하지 않습니다.
JSON 봉투
응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. search는 results와 answer를 포함할 수 있고 extract·map·crawl은 data 아래 Analytics 페이로드를 반환합니다.
연동 순서
대부분 제품은 먼저 검색하고, 승자 URL을 extract한 뒤, 커버리지가 필요하면 map하고, 필요한 경로만 crawl합니다.
01검색
GET /v1/tavily/search?query=…순위 results[]와 선택적 answer입니다.
심화 읽기 전에 후보 URL과 짧은 요약을 확보합니다.
02추출
GET /v1/tavily/extract?urls=…URL당 정제 본문 행(최대 20)입니다.
결과 링크를 두 번째 스크래퍼 없이 AI 준비 텍스트로 바꿉니다.
03맵
GET /v1/tavily/map?url=…루트에서 발견한 URL 목록입니다.
전체 본문 비용 전에 사이트 구조를 열거합니다.
04크롤
GET /v1/tavily/crawl?url=…instructions 아래 추출 본문이 있는 페이지입니다.
문서나 제품 트리를 한 번의 안내 실행으로 가져옵니다.
요청
GET /v1/tavily/search
?query=best+web+scraping+apis
&include_answer=true
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/tavily/extract?urls=https://example.com응답 봉투
{
"success": true,
"data": {
"results": [],
"answer": "…"
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}data 형태
Tavily 라우트는 Analytics 원형을 사용해 answer, results, crawl 행이 목록 전용 매퍼에 잘리지 않습니다.
Analytics (search)search
순위 results[]; 선택 answer; 쿼리 메타(depth, time_taken, total_results)
Analytics (extract)extract
URL별 본문 행, format, 성공과 함께 나열되는 실패
Analytics (map / crawl)map, crawl
map: 사이트그래프 URL 목록; crawl: 추출 본문이 있는 페이지
게이트웨이
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. 프로세스 안 Tavily 사이드카 SDK가 아닙니다.
- 01
엣지 수신
Next.js catch-all이 Hono 소셜 API로 들어갑니다. request_id를 발급하고 키를 인증한 뒤 분당 600회 한도와 키당 동시 50건을 적용합니다.
- 02
검증 후 차감
레지스트리에서 tavily/search, extract, map, crawl을 찾습니다. 필수 파라미터(query, urls, url) 검증이 먼저입니다. 잘못된 입력은 400이며 과금하지 않습니다. 유효 호출은 업스트림 전에 1 크레딧을 원자적으로 차감합니다.
- 03
캐시 또는 조회
platform, resource, params로 캐시 키를 만듭니다. 히트면 즉시 반환하고 credits_used는 0입니다. 미스면 SocialCrawl Tavily fetcher가 하우스 자격으로 api.tavily.com에 POST합니다. 앱이 Tavily bearer 토큰을 붙이지 않습니다.
- 04
정규화 후 반환
업스트림 JSON을 Analytics 원형으로 유지합니다(search의 answer 포함). 성공 봉투로 감싸 빌링 감사에 남깁니다.
과금 규칙
- search 라이브 미스는 1 크레딧입니다.
- extract 라이브 미스는 1 크레딧입니다.
- map 라이브 미스는 1 크레딧입니다.
- crawl 라이브 미스는 1 크레딧입니다.
- 캐시 히트는 0 크레딧입니다.
- 빈 응답과 하드 실패는 자동 환불됩니다.
- 잘못된 파라미터는 400이며 과금하지 않습니다.
- 잔액이 없으면 402이며 과금하지 않습니다.
- 앱 인증에 두 번째 Tavily 계정이 필요 없습니다.
데이터 수집
Tavily는 에이전트와 리서치용 웹 그라운딩입니다. 공개 연산 4개를 프록시해 제품이 SocialCrawl 키 하나에 머물게 합니다.
API에서의 Tavily
선택 답변이 있는 웹 검색, URL 정제 추출, 사이트그래프 map, 다중 페이지 crawl을 제공합니다. 오픈 웹 맥락이 필요할 때 소셜 읽기를 보완합니다.
업스트림
전용 Tavily fetcher가 GET 쿼리 파라미터를 Tavily JSON POST 본문으로 변환합니다. 업스트림은 SocialCrawl 하우스 인증의 api.tavily.com입니다. 앱은 x-api-key만 보냅니다.
응답 형태
success, data, credits_used, request_id, cached를 담은 통합 JSON 봉투를 반환합니다. search는 results와 answer를 보존하고 extract·map·crawl은 Analytics 페이로드를 반환합니다.
미제공 항목
Tavily 대시보드 로그인은 없습니다. 쓰기와 인덱스 관리는 없습니다. extract는 호출당 URL 20개 한도입니다. map은 crawl 전까지 본문 없이 URL만 반환합니다.
필드 매핑
ranked web hits + answer→ Analytics results/answer순위 웹 히트와 선택적 합성 answer
page body per URL→ extract content rows요청 URL별 정제 페이지 본문
sitegraph / crawl pages→ URL list + content사이트그래프 URL 목록 또는 본문이 있는 crawl 페이지
이 API의 활용 분야
이 API가 가장 많이 사용되는 작업입니다.
4active Tavily endpoints in the registry
1 crTavily 라이브 호출당 크레딧
에이전트 웹 그라운딩과 문서 수집
그라운딩에는 include_answer 검색, 결과 URL에는 extract, 문서 트리에는 map 후 crawl을 사용합니다. 소셜 엔드포인트와 같은 키로 도구 난립을 줄입니다. SocialCrawl 키로 Tavily 전 표면을 라이브 호출당 1 크레딧에 제공합니다. 이 네 라우트에 고객 앱의 두 번째 벤더 계정이 필요 없습니다.
search와 extract는 라이브 미스 시 보통 수 초입니다. map과 crawl은 depth, breadth, limit에 비례합니다. 캐시 히트는 0 크레딧으로 즉시 반환됩니다.
Tavily API 활용 사례
Tavily 데이터가 가장 많이 쓰이는 작업입니다. 각 항목에서 엔드포인트 순서와 과금 방식을 확인합니다.
활용 사례
이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.
RAG·에이전트 빌더
Python, 도구 체인, 워커include_answer 검색으로 그라운딩한 뒤 인용 URL을 extract해 임베딩합니다.
문서·리서치 잡
Node, cron, 스토리지 파이프라인문서 루트를 map한 뒤 instructions로 API·제품 페이지만 crawl합니다.
풀스택 제품 팀
TypeScript, Explorer, 동일 SocialCrawl 키프로덕션에 별도 Tavily 키를 두지 않고 소셜 읽기 옆에 오픈 웹 맥락을 붙입니다.
호출 예시
Tavily 라이브 호출은 1 크레딧입니다. 캐시 히트는 무료입니다. search는 query, extract는 urls, map·crawl은 루트 url을 사용합니다.
curl "https://www.socialcrawl.dev/v1/tavily/search?query=best+web+scraping+apis&include_answer=true" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/tavily/extract?urls=https://example.com" \
-H "x-api-key: sc_your_api_key_here"엔드포인트
Tavily API는 어떤 데이터를 돌려주나요
모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
비교
SocialCrawl과 Tavily API (직접 연동), 뭐가 다른가요?
같은 Tavily 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.
| 항목 | SocialCrawl | Tavily API (직접 연동) |
|---|---|---|
| 인증 | 38개 다른 플랫폼과 공유하는 x-api-key 하나면 돼요 | Tavily 계정과 API 키를 따로 만들어야 해요 |
| 시작하기 | 다른 소스와 같은 응답 구조로 /v1/tavily/{resource}에 GET만 보내면 돼요 | Tavily SDK나 REST를 자체 응답 형식으로 따로 다뤄야 해요 |
| 요금 | 호출당 1 크레딧, 잔액 하나를 모든 플랫폼이 같이 써요 | 월 크레딧이 따로 책정된 별도 플랜이에요 |
| 응답 스키마 | search·extract·map·crawl 모두 SocialCrawl 통합 JSON 구조로 와요 | Tavily 고유의 응답 형태예요 |
| 데이터 범위 | 검색·추출·맵·크롤에 더해 같은 키로 Perplexity와 소셜 검색까지 닿아요 | Tavily의 모든 네이티브 파라미터를 그대로 쓸 수 있어요 |
| 무료 시작 | 신용카드 없이 100 크레딧을 드려요 | Tavily 자체 플랜에 월 단위 무료 크레딧이 있어요 |
인증
SocialCrawl
38개 다른 플랫폼과 공유하는 x-api-key 하나면 돼요
Tavily API (직접 연동)
Tavily 계정과 API 키를 따로 만들어야 해요
시작하기
SocialCrawl
다른 소스와 같은 응답 구조로 /v1/tavily/{resource}에 GET만 보내면 돼요
Tavily API (직접 연동)
Tavily SDK나 REST를 자체 응답 형식으로 따로 다뤄야 해요
요금
SocialCrawl
호출당 1 크레딧, 잔액 하나를 모든 플랫폼이 같이 써요
Tavily API (직접 연동)
월 크레딧이 따로 책정된 별도 플랜이에요
응답 스키마
SocialCrawl
search·extract·map·crawl 모두 SocialCrawl 통합 JSON 구조로 와요
Tavily API (직접 연동)
Tavily 고유의 응답 형태예요
데이터 범위
SocialCrawl
검색·추출·맵·크롤에 더해 같은 키로 Perplexity와 소셜 검색까지 닿아요
Tavily API (직접 연동)
Tavily의 모든 네이티브 파라미터를 그대로 쓸 수 있어요
무료 시작
SocialCrawl
신용카드 없이 100 크레딧을 드려요
Tavily API (직접 연동)
Tavily 자체 플랜에 월 단위 무료 크레딧이 있어요
자주 묻는 질문
자주 묻는 질문
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기SocialCrawl의 Tavily API는 무엇인가요?
SocialCrawl x-api-key 하나로 Tavily 웹 검색 API를 가져와 쓸 수 있어요. Tavily는 AI 에이전트와 LLM을 위해 만들어진 검색 API예요. /v1/tavily/{resource} 경로로 호출하고, SNS·개발·검색 데이터와 똑같은 키와 크레딧으로 써요. 별도 Tavily 계정은 필요 없어요.
어떤 Tavily 엔드포인트를 지원하나요?
엔드포인트 4종을 쓰실 수 있어요: Search, Extract, Map, and Crawl. 모두 /v1/tavily/{resource} GET 호출로 받아볼 수 있어요.
Tavily API 키를 따로 발급받아야 하나요?
아니요, SocialCrawl x-api-key 하나면 Tavily까지 다 돼요. api.tavily.com에 가입하거나 두 번째 키를 관리할 필요가 없어요. SocialCrawl이 요청을 대신 전달하고, 기존 크레딧에서 비용을 차감해요. 다른 SocialCrawl 엔드포인트와 똑같은 방식이에요.
Tavily API는 요금이 얼마인가요?
Tavily 엔드포인트는 스탠다드 티어로 호출당 1 크레딧이에요. 새 계정은 신용카드 없이 100 크레딧을 무료로 받을 수 있어요. search, extract, map, crawl 네 가지를 여러 번 충분히 테스트하고 나서 결제하셔도 돼요.
같은 키로 Perplexity나 AI 검색도 쓸 수 있나요?
네, 같은 SocialCrawl 키로 리서치용 Perplexity Sonar와 14개 플랫폼을 아우르는 SocialCrawl AI 소셜 검색까지 닿아요. 키 하나로 Tavily, Perplexity, 소셜 검색을 다 쓸 수 있어서 계정을 여럿 만들 필요 없이 질의에 맞는 백엔드를 골라 쓰면 돼요.
search, crawl, map, extract는 언제 골라 써야 하나요?
검색어로 페이지를 찾을 땐 search, 이미 가진 URL의 본문을 읽을 땐 extract, 사이트의 링크 구조를 빠르게 파악할 땐 map, LLM이 경로를 골라가며 사이트를 순회·수집할 땐 crawl이에요. RAG에는 search·extract, 사이트 수집에는 map·crawl이 잘 맞아요.
Tavily 검색을 API로 쓰는 가장 좋은 방법은 무엇인가요?
Tavily만 쓴다면 자체 무료 티어가 있는 직접 연동도 좋아요. 여러 백엔드를 함께 쓴다면 SocialCrawl이 간편해요. search·extract·map·crawl을 호출당 1 크레딧에 쓰고, 같은 키로 Perplexity Sonar와 소셜 검색까지 닿아요. 신용카드 없이 100 크레딧으로 바로 시작할 수 있어요.
Tavily 데이터 스크래핑, 법적으로 괜찮을까요?
SocialCrawl은 누구나 볼 수 있는 공개 Tavily 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. Tavily 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.
Tavily 스크래핑 API와 공식 Tavily API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 Tavily 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧 하나로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요 — SocialCrawl은 읽기 전용 데이터만 다뤄요.
AI에게 SocialCrawl을 물어보세요