Perplexity API: 답변, 인용, 검색어 - querying.ai

PERPLEXITY는 Perplexity에 묻고, 답변과 인용한 출처, 모델이 실행한 검색을 반환합니다.


taskType	`PERPLEXITY`
읽는 필드	`prompt` (없으면 `query`)
크레딧	1
국가	선택, 기본값 `US`. `CN`은 `422 REGION_UNSUPPORTED`로 거절됩니다.

요청

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "PERPLEXITY", "payload": { "prompt": "best CRM for a small team", "country": "US", "include": { "searchQueries": true } } }'

응답

필드	타입	설명
`text`	string	답변. 항상 있습니다.
`sources`	array	인용 출처: `position`, `url`, `label`, `description`. 항상 있습니다.
`related_queries`	string[]	Perplexity가 제안하는 후속 질문.
`search_model_queries`	array	Perplexity 모델이 실행한 검색. 각각 `{ query, engine, limit }`.
`searchQueries`	string[]	같은 검색을 일반 문자열로. `include.searchQueries`일 때만.
`images`, `videos`	array	답변과 함께 나온 미디어: `title`, `url`, `medium`, `image`, `thumbnail`, `source`, `image_width`, `image_height`, 동영상에는 `duration`.
`markdown`	string	Markdown 답변. 이미지는 제자리에 놓입니다. `include.markdown`일 때만.
`rawResponse`	array	파싱된 스트림 이벤트. `include.rawResponse`일 때만.

images와 videos에서 url은 항목이 나온 페이지이고 image는 그림 자체입니다. 예시:

{
  "text": "HubSpot CRM and Pipedrive are the most common choices for small teams ...",
  "sources": [
    { "position": 1, "url": "https://www.example.com/crm-review", "label": "Best CRM for small teams", "description": "..." }
  ],
  "related_queries": ["Is HubSpot CRM free?"],
  "search_model_queries": [{ "query": "best CRM small team", "engine": "web", "limit": 8 }],
  "searchQueries": ["best CRM small team"]
}

related_queries는 사용자에게 보여 주는 제안입니다. search_model_queries와 searchQueries가 Perplexity가 실제로 검색한 내용입니다.

include 플래그

플래그	효과
`markdown`	`markdown`을 추가합니다.
`searchQueries`	`searchQueries`를 추가합니다.
`rawResponse`	`rawResponse`를 추가합니다.
`html`	Perplexity가 보여 준 화면인 `html`을 추가합니다. 페이지가 저장되면 0.25크레딧. HTML 페이지를 참고하세요.
`analysis`	`analysis`를 추가합니다. 1크레딧. 답변 분석을 참고하세요.
`citationAnalysis`	답변에 Citation Analysis를 실행합니다.

ads와 shopping은 효과가 없습니다. Markdown과 원본 응답을 참고하세요.

관련 문서