Analise uma resposta concluída só com o ID da tarefa

Envie o taskId de uma resposta concluída ao Source Influence, que lê a resposta e as citações por você.

O que muda

• Um único campo, taskId, basta como requisição quando a resposta veio do querying.ai.
• O Markdown da resposta, as URLs citadas na ordem do mecanismo, o prompt, o país e o mecanismo vêm da própria tarefa.
• A análise considera as primeiras 100 URLs citadas, com até 10 tópicos de discussão entre elas.

Como funciona

Qualquer tarefa de resposta concluída sua que o GET /v1/async/task/{id} ainda retorne é analisada só pelo ID. O Source Influence usa o Markdown da resposta, ou o texto quando o mecanismo devolveu texto simples, e as URLs citadas na ordem em que o mecanismo as listou.

A análise cobre as citações que levam a páginas reais, então cards de produtos, cards de vídeo e links de busca do Google ficam de fora.

Onde ajuda

• Analise uma a uma as respostas que seus trabalhos agendados já coletaram.
• Monte um fluxo que roda tarefas de resposta e analisa cada uma assim que termina.

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/source-influence \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskId": "e5aba119-a26e-4f82-a965-35c9234a428b" }'

Campos da requisição

taskIdstringObrigatório

Uma tarefa de resposta sua já concluída. A resposta e as páginas citadas viram answer e citations.

countrystring

País de onde as páginas citadas são lidas. Padrão US.

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": "1d0521d6-26fe-4fbf-9e54-3a97c0e566a3",
    "taskType": "SOURCE_INFLUENCE",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:44:12.823Z"
  },
  "credits": { "creditsToCharge": 133, "creditsCharged": 133 },
  "response": {
    "answer": "Here are several **nearby cafés that look particularly suitable for laptop work**, based on current local listings and work-friendly details:\n…",
    "sources": [
      {
        "id": "s0",
        "url": "https://awifiplace.com/cities/new-york",
        "paragraphs": [
          {
            "id": "s0p4",
            "text": "100 Cafés to Work in New York\n\nCarefully curated from Google reviews: All locations offer WiFi and are verified as laptop-friendly by remote …"
          }
        ]
      }
    ],
    "links": [
      {
        "id": "l0",
        "paragraphId": "s0p4",
        "answerRanges": [
          { "start": 0, "end": 141 },
          { "start": 179, "end": 247 },
          { "start": 248, "end": 288 },
          { "start": 869, "end": 938 }
        ],
        "explanation": "The page describes 100 New York cafés as offering WiFi and verified as laptop-friendly by remote workers, supporting their suitability for laptop work and Wi-Fi use."
      }
    ],
    "insights": [
      {
        "summary": "The recommendations are best read as promising laptop-work options, not guaranteed workspaces: the underlying guides rely on reported Wi‑Fi and work-friendly listings, while noting that connection quality, outlets, and seating can vary.",
        "linkIds": ["l0", "l2", "l3", "l4", "l6", "l7", "l8"]
      }
    ]
  }
}

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.answerstring

A resposta enviada, exatamente como está. Os intervalos são posições UTF-16 deste mesmo texto.

response.sourcesarray

Uma entrada por página citada, com a url e os paragraphs do resultado, cada um com id e text.

response.linksarray

Cada link liga um parágrafo aos answerRanges correspondentes e a uma explanation de uma frase.

response.insightsarray

Resumos curtos do que os links mostram juntos, cada um com os links de base em linkIds.

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

O preço continua o mesmo: os créditos são reservados quando a análise começa e acertados quando ela termina.