Resultados de busca e Reddit chegam à API

Receba em JSON os resultados de busca do Google, do Bing e do Naver e as discussões do Reddit, com a mesma API que você usa para as respostas de IA.

O que você recebe

• GOOGLE_SERP: resultados orgânicos com posição, título, link e trecho, além de perguntas relacionadas, buscas relacionadas e anúncios. Defina page de 1 a 10 para páginas mais profundas.
• BING_SEARCH: os resultados do Bing com o resumo de IA que o Bing escreve acima deles, em aioverview com as fontes.
• NAVER_SERP: os documentos da web do Naver, 15 por página, com page de 1 a 10.
• REDDIT: uma busca de posts, um post com os comentários ou os posts mais recentes de um subreddit.

Como funciona

Os mecanismos de IA montam as respostas a partir da web, então as páginas que se posicionam na busca e os tópicos que as pessoas escrevem no Reddit são a matéria-prima da visibilidade em IA. Esses mecanismos trazem esses dados para o fluxo que você já usa: a mesma requisição, o mesmo webhook e o mesmo formato JSON.

As posições são contadas ao longo das páginas, então o primeiro resultado do Google na página 2 tem a posição 11. Cada tarefa lê os resultados ao vivo no momento da coleta.

Onde ajuda

• Compare quem se posiciona na busca com quem é citado nas respostas de IA para a mesma busca.
• Acompanhe os tópicos do Reddit que formam a opinião na sua categoria.

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": "GOOGLE_SERP",
    "payload": {
      "query": "best project management software for small teams",
      "country": "US"
    }
  }'

Envie BING_SEARCH e NAVER_SERP do mesmo jeito, com query no payload.

Campos da requisição

taskTypestringObrigatório

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

payload.querystringObrigatório

A busca, escrita como o usuário digita na caixa de pesquisa.

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

Página de resultados lida, de 1 a 10. Padrão 1. position continua a contagem entre páginas.

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": "323287e6-d4ef-4797-a337-f6c3b574b7ab",
    "taskType": "GOOGLE_SERP",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:45:07.237Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "page": 1,
    "organicResults": [
      {
        "position": 1,
        "title": "8 Easy-to-Use Project Management Software Platforms for ...",
        "link": "https://ones.com/blog/8-easy-to-use-project-management-software-platforms-for-small-teams/?primary_category=knowledge",
        "snippet": "1 day ago — ONES.com came out on top for teams that need Jira-like power without the complexity, while Trello and Asana hold their ground for basic, visual ...",
        "page": 1
      }
    ],
    "peopleAlsoAsk": [
      { "question": "Does Microsoft Teams have a project management tool?" },
      {
        "question": "What is the best project management software for a small construction company?"
      }
    ]
  }
}

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

Os resultados de busca da página: position, title, link, snippet e page.

response.peopleAlsoAskarray

As perguntas relacionadas que o Google mostra na página.

Pesquise no Reddit

Envie REDDIT com uma query para encontrar posts, acrescente subreddit para ficar numa comunidade, ou envie a url de um post para lê-lo com a primeira página de comentários.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "REDDIT",
    "payload": {
      "query": "best mechanical keyboard for programming",
      "country": "US"
    }
  }'

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

{
  "success": true,
  "task": {
    "id": "fe0a46a2-7bf1-4cd0-8183-d299dc421c70",
    "taskType": "REDDIT",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:47:44.384Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "results": [
      {
        "url": "https://www.reddit.com/r/MechanicalKeyboardsUK/comments/1qz6da6/best_silent_mechanical_keyboard_for_programming/",
        "title": "Best silent mechanical keyboard for programming?",
        "postId": "1qz6da6",
        "preview": "I currently have a mechanical keyboard but I often wake up in the middle of the night and it is quite loud so I can't use my computer because …",
        "subreddit": "MechanicalKeyboardsUK"
      }
    ]
  }
}

payload.subredditstring

Busca dentro de um subreddit; informe o nome que vem depois de r/.

payload.urlstring

O endereço de um post, https://www.reddit.com/r/{subreddit}/comments/{postId}/…. Lê o post com a primeira página de comentários.

payload.commentSortstring

Ordem dos comentários: top (padrão), new, controversial, old ou qa.

response.resultsarray

Os posts que correspondem à busca: postId, title, url, subreddit e preview.

response.postobject

Com a url de um post: título, corpo, autor, pontuação e número de comentários.

response.commentsobject

A primeira página de comentários, cerca de 20 a 25, com autor, corpo, pontuação e profundidade.

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 concluída usa 1 crédito.