Pular para o conteúdo
NovidadesNovo

Social: leia YouTube, Instagram e Threads pela API

Social
Uma solicitação SOCIAL em POST /v1/async/task para a busca do YouTube wireless earbuds review e o primeiro vídeo da resposta com o canal, 62.618 visualizações e 957 curtidas

Pesquise no YouTube, Instagram e Threads e receba vídeos, posts, comentários, perfis e legendas do YouTube em JSON com qualquer chave de API, por 0,5 crédito por solicitação concluída.

O que você recebe

  • platform youtube: resultados de busca, os envios mais recentes de uma busca, a página de um vídeo, comentários com respostas, um canal, os vídeos, Shorts ou lives de um canal, e legendas.
  • platform instagram: posts e reels de uma palavra-chave, um perfil público com os 12 posts mais recentes, um post ou reel e os seus comentários.
  • platform threads: posts de uma palavra-chave, um perfil público com os posts recentes, um post e as suas respostas.
  • As contagens chegam como números, como viewCount, likeCount, commentCount e followerCount, com o horário publishedAt, para comparar posts sem interpretar textos como 62K.

Como funciona

Envie taskType SOCIAL para POST /v1/async/task com uma platform e uma action. search, a ação padrão, recebe query. As outras ações recebem videoId, channel, username ou postUrl, e você pode colar ali a URL da página.

Social lê páginas públicas. No Instagram são os 12 posts mais recentes de um perfil e cerca de uma dúzia de comentários por post, e no Threads cerca de 10 respostas por post. Uma página que não existe ou que exige login encerra a tarefa com PAGE_UNAVAILABLE.

Uma busca de vídeos do YouTube ordenada por relevance retorna nextPageToken para a página seguinte. transcript retorna o text das legendas e segments com tempos nos idiomas que você indicar, e translateTo pede ao YouTube que as traduza. A ferramenta read_social do servidor MCP do querying.ai executa as mesmas leituras no Claude Code, Codex, Cursor e outros clientes MCP.

Onde ajuda

  • Acompanhe dia a dia as visualizações, curtidas e comentários dos vídeos da sua marca e dos concorrentes.
  • Leia os comentários e as respostas de um lançamento no YouTube, Instagram e Threads e anote o que as pessoas perguntam.
  • Passe ao seu modelo a transcrição com marcações de tempo de um vídeo de review e encontre onde ele cita o seu produto.
  • Coloque o que os criadores dizem no YouTube e no Threads ao lado das respostas do ChatGPT e do Google AI Mode para a mesma busca.

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": "SOCIAL",
    "payload": {
      "platform": "youtube",
      "action": "search",
      "query": "wireless earbuds review",
      "limit": 10
    }
  }'

Campos da requisição

taskTypestringObrigatório
O motor que executa a tarefa, como CHATGPT ou GOOGLE.
payload.platformstringObrigatório
A plataforma lida: youtube, instagram ou threads.
payload.actionstring
O que é lido, como search, video, comments ou transcript. Padrão search. Cada plataforma lista as suas ações na documentação.
payload.querystring
A busca para search e recent, escrita como o usuário digita na caixa de busca da plataforma.
payload.limitinteger
Resultados retornados. Uma busca no YouTube aceita de 1 a 50, padrão 10.
webhook.urlstring
Um endereço HTTPS do seu servidor. A tarefa concluída é enviada para lá assim que termina.

Resposta

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

JSON
{
  "success": true,
  "task": {
    "id": "…",
    "taskType": "SOCIAL",
    "status": "COMPLETED",
    "createdAt": "…"
  },
  "credits": { "creditsToCharge": 0.5, "creditsCharged": 0.5 },
  "response": {
    "platform": "youtube",
    "action": "search",
    "query": "wireless earbuds review",
    "order": "relevance",
    "returnedCount": 10,
    "videos": [
      {
        "position": 1,
        "videoId": "YdJh6QdOGME",
        "url": "https://www.youtube.com/watch?v=YdJh6QdOGME",
        "title": "Earbuds Awards 2026 - Best Bluetooth Earbuds by Category!",
        "channelTitle": "Mike O'Brien",
        "channelHandle": "@MikeOBrienMedia",
        "publishedAt": "2026-11-17T15:39:37Z",
        "durationSeconds": 995,
        "viewCount": 62618,
        "likeCount": 957
      },
      "…"
    ],
    "nextPageToken": "eyJyIjpbIllkSmg2UWRPR01FIl19"
  }
}
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.returnedCountinteger
O número de produtos em products.
response.videosarray
Os vídeos na ordem do YouTube: position, videoId, url, title, o canal, publishedAt, durationSeconds, viewCount e likeCount.

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 solicitação concluída usa 0,5 crédito, em todas as plataformas e ações. Só as solicitações concluídas são cobradas. Planos e créditos: https://querying.ai/pricing

Mais novidades

Receba as novidades

Receba atualizações do produto por e-mail.

Feed RSS