Veja as buscas que o Perplexity faz para responder

Capture a resposta do Perplexity a qualquer prompt no seu mercado, com as fontes numeradas, as buscas que ele fez e as perguntas de acompanhamento que sugere.

O que você recebe

• text e markdown: a resposta completa, em texto simples e formatada.
• sources: as fontes numeradas por trás da resposta, cada uma com URL, título e uma breve descrição.
• related_queries: as perguntas de acompanhamento que o Perplexity sugere em seguida.
• Imagens, vídeos, lugares, hotéis e cards de produtos sempre que a resposta os mostra.

Como funciona

O Perplexity responde a cada pergunta com uma busca na web, e as fontes numeradas mostram exatamente de onde vem cada afirmação. Cada tarefa faz a sua pergunta a partir do país definido e devolve a resposta e as fontes como as pessoas desse mercado as veem.

Ative include.searchQueries para receber também as buscas que o Perplexity fez, que revelam como ele divide uma pergunta em etapas de pesquisa.

Onde ajuda

• Veja em quais domínios o Perplexity se apoia na sua categoria e onde suas páginas aparecem entre as fontes.
• Transforme as perguntas de acompanhamento sugeridas em novos prompts para acompanhar.
• Compare as recomendações do Perplexity com as do ChatGPT e do Gemini nos mesmos prompts.

Envie a requisição

Envie a requisição com a sua chave de API no cabeçalho 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 }
    }
  }'

Campos da requisição

taskTypestringObrigatório

O motor que executa a tarefa, como CHATGPT ou GOOGLE.

payload.promptstringObrigatório

A pergunta, escrita como o usuário digita no chat. Até 100.000 caracteres.

payload.countrystring

Código de país de duas letras do mercado de onde a pergunta parte, como US, KR ou JP. Padrão US.

payload.include.markdownboolean

Com true, chega também markdown: a resposta com títulos, listas, tabelas e links.

payload.include.searchQueriesboolean

Com true, chega também searchQueries: as buscas na web que o motor fez para escrever a resposta.

webhook.urlstring

Um endereço HTTPS do seu servidor. A tarefa concluída é enviada para lá assim que termina.

idempotencyKeystring

Seu próprio ID para a requisição. Cada chave cria uma única tarefa por conta, então um reenvio continua sendo uma tarefa.

Resposta

Uma tarefa concluída chega assim, resumida para facilitar a leitura.

{
  "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 e, no fim, COMPLETED com a resposta ou FAILED com error.

credits.creditsChargedinteger

Créditos cobrados pela tarefa concluída. Uma tarefa que falhou cobra 0.

response.textstring

A resposta em texto puro.

response.markdownstring

A resposta com a formatação: títulos, listas, tabelas e links.

response.sourcesarray

As páginas que a resposta cita, na ordem do motor, com position, url e label.

response.searchQueriesarray

As buscas na web que o motor fez para escrever a resposta.

Receba o resultado

A requisição devolve a tarefa na hora, com status QUEUED. Consulte GET /v1/async/task/{id} até status virar COMPLETED ou FAILED, ou adicione webhook.url e a tarefa concluída chega ao seu servidor com os mesmos task, credits e response. Os resultados ficam disponíveis por 24 horas após o fim da tarefa.

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

Preço

Cada tarefa do Perplexity concluída usa 1 crédito.