근거 연구
1 크레딧/v1/perplexity/researchPerplexity Sonar로 실시간 웹을 조사합니다. data.answer와 data.sources[{ url, title? }]를 반환합니다. 짧은 사실 답변에서는 sources가 비어 있을 수 있습니다. 업스트림 실패 시 자동 환불됩니다.
query
Perplexity 엔드포인트
연구용 라이브 엔드포인트는 1개입니다. 자연어 질의를 넣으면 합성 답변과 인용 URL을 반환합니다. 고정 소셜 플랫폼 조회가 아니라 현재 웹 근거가 필요한 열린 질문에 맞습니다. 순위 결과나 소셜 팬아웃이 필요하면 Tavily와 search/everywhere를 함께 사용합니다.
Perplexity API1개 엔드포인트 지원
문서 보기자연어 질문을 실시간 웹에서 조사해 서술형 답변과 답변의 근거가 된 출처 URL을 함께 반환합니다.
플랫폼 하나를 정해 놓고 하는 조회가 아니라, 최신 뉴스나 투자 유치처럼 지금 정보가 필요한 열린 질문에 사용하세요.
GET/v1/perplexity/research?query=What+is+the+capital+of+France%3F
query · Natural-language research prompt. Sonar autonomously searches the live web and grounds the response in real sources. No prompt-engineering required — phrase it as you would to a search engine or research assistant.
$ curl https://www.socialcrawl.dev/v1/perplexity/research?query=What+is+the+capital+of+France%3F \
-H "x-api-key: sc_YOUR_API_KEY"— · 대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다Perplexity API 동작
Perplexity도 /v1/perplexity 아래의 일반 SocialCrawl 엔드포인트입니다. API 키로 GET을 호출하고 라이브 미스에 1 크레딧을 쓰며 동일한 JSON 봉투를 받습니다. Sonar는 AI 게이트웨이로 실행됩니다. Perplexity OAuth와 별도 SDK는 없습니다.
호출 인증
x-api-key 헤더에 키를 보냅니다. Perplexity 개발자 계정과 별도 Sonar 키는 필요 없습니다. Tavily, search/everywhere, 소셜 카탈로그에 같은 SocialCrawl 키를 사용합니다.
GET과 쿼리 파라미터
research 라우트는 GET입니다. query에 자연어 프롬프트를 넣습니다. 과금 전에 필수 파라미터를 검증합니다.
크레딧 과금
라이브 연구는 1 크레딧입니다. 캐시 히트는 0 크레딧입니다. 빈 응답과 하드 실패는 환불됩니다. 잘못된 파라미터는 400이며 과금하지 않습니다. 잔액이 없으면 402이며 과금하지 않습니다.
JSON 봉투
응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. data에는 answer와 sources[]가 있습니다.
연동 순서
대부분 제품은 근거 답변으로 시작한 뒤 순위 URL이나 플랫폼 네이티브 히트가 필요할 때 웹 검색 또는 소셜 팬아웃으로 확장합니다.
01연구
GET /v1/perplexity/research?query=…Analytics입니다. answer와 sources[{ url, title? }]를 반환합니다.
실시간 웹 근거가 필요한 열린 질문은 여기서 먼저 처리합니다.
02웹 검색(Tavily)
GET /v1/tavily/search?query=…순위 웹 결과와 선택적 본문 extract입니다.
합성 답변만이 아니라 결과 목록이나 페이지 전문이 필요할 때 사용합니다.
03소셜 팬아웃
GET /v1/search/everywhere?query=…search/everywhere 다중 플랫폼 소셜 히트입니다.
열린 웹만이 아니라 소셜에서 사람들이 말하는 내용이 필요할 때 사용합니다.
요청
GET /v1/perplexity/research
?query=what+is+rrf+fusion+in+search
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here응답 봉투
{
"success": true,
"data": {
"answer": "…",
"sources": [
{ "url": "https://example.com", "title": "…" }
]
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}data 형태
아키타입은 Analytics입니다. 소셜 Post 형태로 강제하지 않고 answer와 sources를 유지합니다.
Analytics (answer)research
answer: 실시간 웹 출처에 근거한 서술형 답변
Analytics (sources)research sources
sources[]: { url, title? }. 짧은 사실 답변에서는 비어 있을 수 있습니다
게이트웨이
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. Perplexity 전용 사이드카가 아닙니다.
- 01
엣지 수신
Next.js catch-all이 Hono 소셜 API로 들어갑니다. request_id를 발급하고 키를 인증한 뒤 키별 한도와 동시성을 적용합니다.
- 02
검증 후 차감
레지스트리에서 perplexity/research를 찾습니다. 필수 query 검증이 먼저입니다. 잘못된 입력은 400이며 과금하지 않습니다. 유효 호출은 업스트림 전에 1 크레딧을 원자적으로 차감합니다.
- 03
캐시 또는 조회
platform, resource, params로 캐시 키를 만듭니다. 히트면 즉시 반환하고 credits_used는 0입니다. 미스면 Vercel AI 게이트웨이로 Perplexity Sonar를 호출합니다. 정책이 허용하면 5xx와 네트워크 오류를 재시도합니다.
- 04
정규화 후 반환
업스트림 텍스트와 인용을 Analytics { answer, sources[] }로 매핑하고 스키마를 검증한 뒤 성공 봉투로 감싸 빌링 감사에 남깁니다.
과금 규칙
- 라이브 연구 미스는 1 크레딧입니다.
- 캐시 히트는 0 크레딧입니다.
- 빈 응답과 하드 실패는 자동 환불됩니다.
- 잘못된 파라미터는 400이며 과금하지 않습니다.
- 잔액이 없으면 402이며 과금하지 않습니다.
- Perplexity 개발자 계정은 필요 없습니다.
- 카탈로그 전 구간과 같은 SocialCrawl 키를 사용합니다.
- Sonar는 AI 게이트웨이로 호출되며 ScrapeCreators가 아닙니다.
- 짧은 사실 답변에서는 sources 배열이 비어 있을 수 있습니다.
데이터 수집
Perplexity 연구는 Sonar를 통한 실시간 웹 근거 수집입니다. 답변과 인용을 SocialCrawl 봉투로 노출하므로 별도 벤더 계정을 열 필요가 없습니다.
API에서의 Perplexity
열린 웹에 대한 자연어 연구입니다. 서술형 답변과 근거 URL을 반환합니다. 소셜 피드, 프로필, 댓글 트리 엔드포인트가 아닙니다.
업스트림
업스트림은 Vercel AI 게이트웨이의 Perplexity Sonar입니다(kind ai-perplexity). ScrapeCreators가 아닙니다. 고객 측 Perplexity 키나 개발자 가입은 없습니다.
응답 형태
success, data, credits_used, request_id, cached를 담은 통합 JSON 봉투를 반환합니다. data는 answer와 sources[{ url, title? }]를 가진 Analytics 형태입니다.
미제공 항목
채팅 이력, 멀티턴 세션, 쓰기 도구는 없습니다. 별도 Perplexity 과금 표면도 없습니다. 순위 SERP나 페이지 extract는 Tavily 또는 Web을, 소셜 팬아웃은 search/everywhere를 사용합니다.
필드 매핑
Sonar answer text→ Analytics.answerSonar가 합성한 답변 텍스트
citation URLs→ Analytics.sources[]Sonar가 근거로 쓴 인용 URL
optional titles→ sources[].titleSonar가 제공하면 포함되는 선택 제목
이 API의 활용 분야
이 API가 가장 많이 사용되는 작업입니다.
1active Perplexity endpoints in the registry
1 cr라이브 연구 크레딧 비용
인용이 있는 근거 연구 답변
호출은 최신 웹 근거가 필요한 열린 질문(뉴스, 투자, 제품 사실, 짧은 리서치 메모)에 모입니다. 많은 파이프라인은 이후 Tavily나 search/everywhere로 순위 목록이나 소셜 맥락을 보강합니다. Perplexity 개발자 계정 없이 1 크레딧으로 인용 포함 Sonar 답변을 받습니다. Tavily와 search/everywhere와 같은 SocialCrawl 키를 사용합니다.
라이브 연구는 Sonar와 AI 게이트웨이에 의존합니다. 단순 소셜 프로필 읽기보다 길 수 있으며 연구 호출로 취급해야 합니다.
활용 사례
이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.
리서치 에이전트
Python, 워커, 노트북제품·시장 자유 질문을 answer와 sources로 바꿔 메모, RAG 초안, 내부 봇에 넣습니다.
콘텐츠·SEO 팀
Node, CMS 잡, 편집근거 초안 답변과 인용 URL을 받은 뒤 Tavily와 search/everywhere로 더 깊은 SERP·소셜 스윕을 이어갑니다.
백엔드 제품 잡
Go, 큐, Explorer이미 SocialCrawl 키로 소셜·웹 엔드포인트를 쓰는 파이프라인에 research를 연결합니다. 캐시 히트로 동일 반복 비용을 낮춥니다.
엔드포인트
Perplexity API는 어떤 데이터를 돌려주나요
모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
비교
SocialCrawl과 Perplexity API (직접 연동), 뭐가 다른가요?
같은 Perplexity 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.
| 항목 | SocialCrawl | Perplexity API (직접 연동) |
|---|---|---|
| 인증 | SNS·개발 데이터와 같은 x-api-key 하나면 돼요 | Perplexity 개발자 계정과 API 키를 따로 만들어야 해요 |
| 시작하기 | query 파라미터를 담은 GET 요청 하나면 끝이에요 | 챗 컴플리션 연동에 모델·파라미터 관리가 따라와요 |
| 요금 | 리서치 호출당 1 크레딧, 48개 플랫폼이 잔액 하나를 같이 써요 | 토큰 기반 과금을 따로 충전하고 따로 추적해야 해요 |
| 응답 스키마 | 출처 달린 답변이 SocialCrawl 통합 JSON 구조로 와요 | OpenAI 스타일 챗 컴플리션 페이로드예요 |
| 데이터 범위 | 키 하나로 Sonar 리서치에 Tavily·소셜 검색·개발 데이터까지 닿아요 | Sonar 모델 전 라인업과 세밀한 모델 제어를 쓸 수 있어요 |
| 무료 시작 | 가입하면 신용카드 없이 100 크레딧을 드려요 | 선불 크레딧 충전이 필요하고 모델·토큰에 따라 비용이 달라져요 |
인증
SocialCrawl
SNS·개발 데이터와 같은 x-api-key 하나면 돼요
Perplexity API (직접 연동)
Perplexity 개발자 계정과 API 키를 따로 만들어야 해요
시작하기
SocialCrawl
query 파라미터를 담은 GET 요청 하나면 끝이에요
Perplexity API (직접 연동)
챗 컴플리션 연동에 모델·파라미터 관리가 따라와요
요금
SocialCrawl
리서치 호출당 1 크레딧, 48개 플랫폼이 잔액 하나를 같이 써요
Perplexity API (직접 연동)
토큰 기반 과금을 따로 충전하고 따로 추적해야 해요
응답 스키마
SocialCrawl
출처 달린 답변이 SocialCrawl 통합 JSON 구조로 와요
Perplexity API (직접 연동)
OpenAI 스타일 챗 컴플리션 페이로드예요
데이터 범위
SocialCrawl
키 하나로 Sonar 리서치에 Tavily·소셜 검색·개발 데이터까지 닿아요
Perplexity API (직접 연동)
Sonar 모델 전 라인업과 세밀한 모델 제어를 쓸 수 있어요
무료 시작
SocialCrawl
가입하면 신용카드 없이 100 크레딧을 드려요
Perplexity API (직접 연동)
선불 크레딧 충전이 필요하고 모델·토큰에 따라 비용이 달라져요
자주 묻는 질문
자주 묻는 질문
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기SocialCrawl의 Perplexity API는 무엇인가요?
SocialCrawl 키 하나로 Perplexity Sonar 웹 리서치를 가져오는 거예요. SocialCrawl이 Vercel AI Gateway를 통해 Perplexity Sonar에 연결해 드려서, /v1/perplexity/research를 호출하면 자연어 질문에 대한 출처가 달린 정리된 답변을 받아볼 수 있어요. SNS·개발 데이터와 같은 크레딧으로 쓰여요.
Perplexity 키를 따로 발급받아야 하나요?
아니요, SocialCrawl x-api-key 하나면 돼요. Perplexity 개발자 계정을 따로 만들거나, 별도 Perplexity 키를 관리하거나, 결제를 두 번 연결할 필요가 없어요. 키 하나, 크레딧 하나로 Perplexity Sonar까지 함께 닿아요.
Perplexity API는 SocialCrawl에서 요금이 얼마인가요?
리서치 엔드포인트는 호출당 1 크레딧(스탠다드 티어)이 들어요. 새 계정은 신용카드 없이 100 크레딧을 무료로 받을 수 있어서, 유료 플랜으로 넘어가기 전에 리서치 질의를 100번 정도 충분히 돌려보실 수 있어요.
응답으로는 무엇이 오나요?
질문에 대한 정리된 리서치 답변과 함께, Perplexity Sonar가 그 답을 쓸 때 참고한 웹 출처와 인용이 같이 와요. 자연어 답변 텍스트와 출처 URL을 JSON으로 받아서, 인용을 그대로 보여주거나 직접 만든 파이프라인에 넣어 쓰실 수 있어요.
같은 키로 Tavily나 AI 소셜 검색도 쓸 수 있나요?
네, 같은 SocialCrawl 키로 여러 AI 검색·리서치 백엔드에 닿을 수 있어요. 여기서는 Perplexity Sonar 웹 리서치를, /v1/tavily/search로는 Tavily 웹 검색을, /v1/twitter/ai-search와 /v1/search/everywhere로는 AI 소셜 검색을 쓸 수 있어요. 키 하나, 크레딧 하나로요.
리서치 엔드포인트는 언제 쓰면 좋나요?
검색 링크 목록이 아니라 최신 웹에서 정리된 출처 달린 답이 필요할 때 써보세요. 리서치 에이전트, RAG 보강, 사실 확인, 브리핑 흐름에 잘 맞아요. SNS에 특화된 결과가 필요하다면 SocialCrawl의 AI 소셜 검색과 함께 쓰시면 돼요.
Perplexity를 API로 쓰는 가장 좋은 방법은 무엇인가요?
모델을 세밀하게 제어해야 한다면 Perplexity 직접 연동이 맞아요. 이미 쓰는 키 하나로 출처 달린 웹 리서치만 필요하다면 SocialCrawl의 /v1/perplexity/research가 간편해요. 호출당 1 크레딧에 Sonar 답변과 출처를 함께 돌려드리고, 신용카드 없이 100 크레딧으로 시작할 수 있어요.
Perplexity 데이터 스크래핑, 법적으로 괜찮을까요?
SocialCrawl은 누구나 볼 수 있는 공개 Perplexity 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. Perplexity 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.
Perplexity 스크래핑 API와 공식 Perplexity API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 Perplexity 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧 하나로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요 — SocialCrawl은 읽기 전용 데이터만 다뤄요.
AI에게 SocialCrawl을 물어보세요