체인지로그새 기능

Perplexity가 어떤 검색어로 답했는지 알려 줘요

Perplexity
무선 이어폰을 다룬 Perplexity 답변과 출처가 담긴 JSON 결과

내 시장에서 Perplexity에 질문하고, 번호가 붙은 출처와 실행한 검색어, 추천 후속 질문까지 답변과 함께 받아요.

받는 결과

  • text, markdown: 답변 전문을 일반 텍스트와 서식 있는 형태로 받습니다.
  • sources: 답변의 근거가 된 번호 붙은 출처입니다. 각각 URL, 제목, 짧은 설명이 붙습니다.
  • related_queries: Perplexity가 다음으로 제안하는 후속 질문입니다.
  • 답변에 이미지, 동영상, 장소, 호텔, 상품 카드가 나오면 함께 받습니다.

동작 방식

Perplexity는 모든 질문에 웹 검색으로 답하고, 번호가 붙은 출처로 각 문장의 근거를 정확히 보여 줍니다. 태스크마다 지정한 국가에서 질문하고, 그 시장 사람들이 보는 그대로 답변과 출처를 돌려줍니다.

include.searchQueries를 켜면 Perplexity가 실행한 검색어도 받습니다. 질문을 어떤 조사 단계로 나눠 풀었는지 알 수 있습니다.

이렇게 활용하세요

  • 내 카테고리에서 Perplexity가 기대는 도메인과, 출처 사이에서 내 페이지가 차지하는 위치를 확인합니다.
  • 추천 후속 질문을 추적할 새 질문으로 활용합니다.
  • 같은 질문에 대한 Perplexity의 추천을 ChatGPT, Gemini와 비교합니다.

요청 보내기

API 키를 Authorization 헤더에 넣어 요청을 보냅니다.

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": "Recommend 3 wireless earbuds for commuting. Compare noise cancellation and battery life in a short table, with sources. Keep it under 180 words.",
      "country": "US",
      "include": { "markdown": true }
    }
  }'

요청 필드

taskTypestring필수
실행할 엔진입니다. CHATGPT, GOOGLE 같은 값을 넣습니다.
payload.promptstring필수
사용자가 채팅에 입력하듯 쓴 질문입니다. 최대 100,000자.
payload.countrystring
질문할 시장의 두 글자 국가 코드입니다. US, KR, JP 등. 기본값 US.
payload.include.markdownboolean
true면 제목, 목록, 표, 링크를 살린 markdown을 함께 받습니다.
payload.include.searchQueriesboolean
true면 엔진이 답을 쓰려고 실행한 웹 검색어 searchQueries를 함께 받습니다.
webhook.urlstring
서버의 HTTPS 주소입니다. 태스크가 끝나는 즉시 결과를 이 주소로 보냅니다.
idempotencyKeystring
요청에 붙이는 고유 ID입니다. 키 하나는 계정에서 태스크 하나를 만들므로, 다시 보내도 태스크는 하나로 유지됩니다.

응답

완료된 태스크는 이런 형태입니다. 길이를 줄여 보여 드립니다.

JSON
{
  "success": true,
  "task": {
    "id": "67030796-8ecd-4aed-b2c4-6ced6639a313",
    "taskType": "PERPLEXITY",
    "status": "COMPLETED",
    "createdAt": "2026-09-10T02:34:24.023Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "text": "For commuting, I’d choose **Sony for strongest all-around isolation**, **Bose for maximum ANC comfort**, or **AirPods for Apple integration**.",
    "markdown": "| Earbuds | Noise cancellation | Battery life* | Best for |\n|---|---|---:|---|\n| **Sony WF-1000XM5** | Excellent; measured 32 dB attenuation in key transit-noise frequencies | 8h / 24h case | Android and mixed devices |\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://www.rtings.com/headphones/reviews/best/wireless-earbuds",
        "label": "The 6 Best Wireless Earbuds of 2026 - RTINGS.com",
        "description": "The best wireless earbuds we've tested are the Sony WF-1000XM6. These buds offer top-tier ANC performance."
      },
      {
        "position": 2,
        "url": "https://www.businessinsider.com/guides/tech/best-earbuds",
        "label": "The best earbuds of 2026, tested by audio experts - Business Insider",
        "description": "The best wireless earbuds offer great audio quality in a compact design. These are our top picks from Sony, Bose, Technics, Anker, Apple, and JLab."
      }
    ]
  }
}
task.statusstring
QUEUED, PROCESSING을 거쳐 답변과 함께 COMPLETED로, 또는 error와 함께 FAILED로 끝납니다.
credits.creditsChargedinteger
끝난 태스크에 청구된 크레딧입니다. 실패한 태스크는 0입니다.
response.textstring
답변 평문입니다.
response.markdownstring
서식을 살린 답변입니다. 제목, 목록, 표, 링크가 그대로 담깁니다.
response.sourcesarray
답변이 인용한 페이지입니다. 엔진이 보여 준 순서대로 position, url, label이 담깁니다.
response.searchQueriesarray
엔진이 답을 쓰려고 실행한 웹 검색어입니다.

결과 받기

요청하면 status가 QUEUED인 태스크가 바로 돌아옵니다. status가 COMPLETED나 FAILED가 될 때까지 GET /v1/async/task/{id}로 조회하거나, webhook.url을 넣어 같은 task, credits, response를 서버로 받으세요. 결과는 태스크가 끝난 뒤 24시간 동안 조회됩니다.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

요금

완료된 Perplexity 태스크마다 1크레딧이 차감됩니다.

다른 업데이트

새 소식을 받아보세요

제품 업데이트를 이메일로 보내드립니다.

RSS 구독