
Social: leia YouTube, Instagram e Threads pela API
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.

Classifique as marcas que os mecanismos de IA citam em um mercado, com share of voice e tendência diária.
Um monitor de marca acompanha uma marca. Um monitor de categoria acompanha um mercado: você nomeia a categoria, agrupa os prompts por subárea, e cada execução faz esses prompts aos seus mecanismos e registra quais marcas cada resposta cita. Defina mode como CATEGORY ao criar; o tipo fica fixo durante toda a vida do monitor.
category: o mercado como um comprador o chama, de 1 a 80 caracteres.promptTopics: liga cada prompt à sua subárea, com até 30 subáreas de no máximo 60 caracteres. Os prompts fora desse mapa cobrem a categoria inteira.competitors: até 25 marcas que você informa. Depois da primeira execução, uma leitura semanal das respostas adiciona até mais 25 marcas que elas citam.GET /v1/monitors/{id}/analytics devolve o relatório. Em category.brands, o share of voice é 100 × as menções de uma marca ÷ todas as menções acompanhadas, então as parcelas de um período somam 100. A taxa de uma marca divide pelo próprio sampleSize, as respostas avaliadas enquanto ela estava na lista, então uma marca adicionada hoje é medida a partir de hoje.
No painel, crie um monitor e escolha Categoria como tipo de monitor. Digite um tema e clique em Executar pesquisa: o Prompt Research preenche os prompts, as subáreas e as marcas para ordenar a partir da demanda de busca em KR ou US, e você revisa tudo antes de criar o monitor.
Envie a requisição com a sua chave de API no cabeçalho Authorization.
curl -X POST https://api.querying.ai/v1/monitors \
-H "Authorization: Bearer $QUERYING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Running shoes market (US)",
"mode": "CATEGORY",
"category": "Running shoes",
"engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
"prompts": [
"What are the best running shoes to choose?",
"What are the best trail running shoes to choose?",
"What are the best waterproof running shoes to choose?"
],
"promptTopics": {
"What are the best running shoes to choose?": "Choosing running shoes",
"What are the best trail running shoes to choose?": "Trail running shoes",
"What are the best waterproof running shoes to choose?": "Running shoe features"
},
"competitors": [
{ "name": "HOKA" },
{ "name": "On" },
{ "name": "Nike" }
],
"country": "US",
"intervalHours": 168
}'namestringObrigatóriomodestringObrigatórioBRAND (padrão) acompanha sua marca. CATEGORY classifica todas as marcas de um mercado.categorystringObrigatórioenginesarrayObrigatórioCHATGPT, GEMINI, PERPLEXITY e GOOGLE.promptsarrayObrigatóriopromptTopicsobjectKids. O relatório classifica as marcas por subsetor.competitorsarraycountrystringUS.intervalHoursinteger1 a cada hora, 24 diária, 168 semanal.A resposta, resumida para facilitar a leitura.
{
"success": true,
"data": {
"monitor": {
"id": "…",
"name": "Running shoes market (US)",
"mode": "CATEGORY",
"category": "Running shoes",
"engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
"country": "US",
"intervalHours": 168,
"enabled": true,
"nextRunAt": "…"
}
}
}data.monitor.idstringdata.monitor.nextRunAtstringintervalHours.GET /v1/monitors/{id}/analytics devolve o relatório dos últimos 30 dias. Os números abaixo vêm do relatório público de tênis de corrida, resumidos para facilitar a leitura.
curl "https://api.querying.ai/v1/monitors/$MONITOR_ID/analytics" \
-H "Authorization: Bearer $QUERYING_API_KEY"{
"success": true,
"data": {
"monitor": {
"id": "0b787ca9-f680-47ac-beaa-72c383b597c1",
"name": "Running shoes market (US)",
"mode": "CATEGORY"
},
"window": {
"since": "2026-09-02T17:23:17.290Z",
"until": "2026-10-02T17:23:17.290Z"
},
"category": {
"name": "Running shoes",
"brands": [
{
"rank": 1,
"name": "On",
"mentions": 21,
"sampleSize": 21,
"mentionRate": 100,
"shareOfVoice": 18.421052631578945,
"changePp": null
},
{
"rank": 2,
"name": "HOKA",
"mentions": 15,
"sampleSize": 21,
"mentionRate": 71.42857142857143,
"shareOfVoice": 13.157894736842104,
"changePp": null
},
{
"rank": 3,
"name": "Nike",
"mentions": 14,
"sampleSize": 21,
"mentionRate": 66.66666666666666,
"shareOfVoice": 12.280701754385964,
"changePp": null
}
],
"topics": [
{
"topic": "Trail running shoes",
"prompts": 1,
"runs": 3,
"leaders": [
{ "name": "HOKA", "mentionRate": 100 },
{ "name": "On", "mentionRate": 100 },
{ "name": "Salomon", "mentionRate": 100 }
]
}
]
}
}
}category.brandsarrayrank, mentionRate e shareOfVoice.category.topicsarrayGET /v1/monitors/{id}/results traz uma linha por resposta, com as marcas citadas em competitorHits. Acrescente format=csv para receber um arquivo que abre em qualquer planilha:
curl "https://api.querying.ai/v1/monitors/$MONITOR_ID/results?format=csv" \
-H "Authorization: Bearer $QUERYING_API_KEY"ran_at,monitor,engine,prompt,mentioned,cited,position,competitors,task_id
2026-09-30T11:52:14.381000Z,Running shoes market (US),PERPLEXITY,What are the best barefoot running shoes to choose?,false,false,,On | Nike | Vibram | Merrell | Xero Shoes | Vivobarefoot | Whitin,39bc264d-205f-4824-8750-7bb6564fa4d0
2026-09-30T11:51:33.415000Z,Running shoes market (US),PERPLEXITY,What are the best waterproof running shoes to choose?,false,false,,HOKA | On | Brooks | Salomon,bc96f867-7349-4987-b498-f0080c149f3d
2026-09-30T11:51:14.888000Z,Running shoes market (US),PERPLEXITY,What are the best running shoes for kids?,false,false,,HOKA | On | ASICS | Nike | New Balance,6b8222fd-01bd-44d7-9a0b-8d0aecb32e19Uma execução custa o mesmo que a de um monitor de marca: uma tarefa por prompt e mecanismo, pelo preço em créditos de cada mecanismo. Encontrar as marcas do mercado soma 100 créditos por mês, divididos entre as execuções, e a pesquisa que preenche o formulário custa 12 créditos.

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.

Dê busca na web ao seu agente em uma só chamada: cada resultado chega com os trechos da página que respondem à busca, por 0,5 crédito a busca.
Receba atualizações do produto por e-mail.