v0.2.0-beta

OpenAPI 3.1.0

LLM Mentions em tempo real

Felo API Support

MIT

Servidor

https://openapi.felo.ai

Bibliotecas Cliente

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operações

post/v1/beta/dataforseo/ai_optimization/llm_mentions/search/live

LLM Mentions em tempo real

As respostas individuais em que um assistente mencionou seu alvo. Retorna total_count, current_offset, search_after_token e items — pagine com o token, não com offset, após as primeiras páginas. ⚠️ target é um array de objetos, cada um {"domain": "..."} ou {"keyword": "..."}; uma string simples é rejeitada por tipo incorreto e um array de strings com 'Each target item must be an object'. Os campos de filtro vêm de get_dataforseo_ai_llm_mentions_available_filters. Encapsulado no envelope do DataForSEO: dados em tasks[0].result, resultado em tasks[0].status_code — uma requisição rejeitada ainda retorna HTTP 200. Para contagens em vez das menções em si, use post_dataforseo_ai_llm_mentions_aggregated_metrics_live.

Referência de preços

Medição: Custo da resposta reportado.
Estimativa de referência por requisição: USD 0.701.
Multiplicador de referência do cliente: 1.0. Não o aplique novamente a um valor de cliente já liquidado.

Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.

Corpo

obrigatório

application/json

Tipo: array object[]
- target
  Tipo: array object[]
  obrigatório
  
  array de objetos contendo entidades de destino campo obrigatório você pode especificar até 10 entidades (objetos) no campo target uma entidade de destino pode conter um domínio ou uma palavra-chave e parâmetros relacionados. Exemplos: array targets com uma entidade de domínio [{"domain": "en.wikipedia.org", "search_filter": "exclude"}] array targets com uma entidade de palavra-chave [{"keyword": "bmw", "search_scope": ["question"], "match_type ": "partial_match"}] array targets com várias entidades [{"domain": "en.wikipedia.org", "search_filter": "exclude"}, {"keyword": "bmw", "match_type ": "partial_match", "search_scope": ["answer"]}]
  
  domain
  Tipo: string
  obrigatório
  
  domínio de destino campo obrigatório se você não especificar keyword você pode especificar até 63 caracteres no campo domain; um domínio deve ser especificado sem https:// e www.
  
  include_subdomains
  Tipo: boolean
  
  indica se os subdomínios do domínio de destino serão incluídos na pesquisa campo opcional se definido como true, os subdomínios serão incluídos na pesquisa valor padrão: false
  
  keyword
  Tipo: string
  
  palavra-chave de destino campo obrigatório se você não especificar domain você pode especificar até 250 caracteres no campo keyword todos os %## serão decodificados (o caractere ‘+’ será decodificado como espaço) se precisar usar o caractere “%” na sua keyword, especifique-o como “%25”; se precisar usar o caractere “+” na sua keyword, especifique-o como “%2B”saiba mais sobre as regras e limitações dos campos keyword e keywords nas APIs do DataForSEO neste artigo da Central de Ajuda
  
  match_type
  Tipo: string
  
  tipo de correspondência da palavra-chave de destino define como a palavra-chave especificada é correspondida campo opcional valores possíveis: word_match - pesquisa de texto completo por termos que correspondem à palavra-chave semente especificada, com palavras adicionais incluídas antes, depois ou dentro da frase-chave (por exemplo, pesquisar por "light" retornará resultados com "light bulb", "light switch"); partial_match - pesquisa de substring que encontra todas as ocorrências que contêm a sequência de caracteres especificada, mesmo que apareça dentro de uma palavra maior (por exemplo, pesquisar por "light" retornará resultados com "lighting", "highlight"); valor padrão: word_match
  
  search_filter
  Tipo: string
  
  Filtro de pesquisa de entidade: incluir ou excluir; o padrão é incluir.
  
  search_scope
  Tipo: array string[]
  
  Escopo da pesquisa. Entidades de domínio: any, sources, search_results. Entidades de palavra-chave: any, question, answer, brand_entities, fan_out_queries. Padrão: any.
- filters
  Tipo: array
  
  array de parâmetros de filtragem de resultados campo opcional você pode adicionar vários filtros de uma vez (máximo de 8 filtros) você deve definir um operador lógico and, or entre as condições os seguintes operadores são suportados: =, in, not_in, like, not_like, ilike, not_ilike, match, not_match você pode usar o operador % com like e not_like para corresponder a qualquer string de zero ou mais caracteres exemplo: ["ai_search_volume",">","1000"] A lista completa de filtros possíveis está disponível aqui.
- language_code
  Tipo: string
  
  código do idioma de pesquisa campo opcional se você usar este campo, não precisa especificar language_name; você pode obter a lista de idiomas disponíveis do mecanismo de busca e seus language_code fazendo uma requisição separada para https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages valor padrão: en Observação: os dados do chat_gpt estão disponíveis apenas para en
- language_name
  Tipo: string
  
  nome completo do idioma de pesquisa campo opcional se você usar este campo, não precisa especificar language_code; se você não especificar este campo, o language_code com valor en será usado por padrão; você pode obter a lista de idiomas disponíveis do mecanismo de busca e seus language_name fazendo uma requisição separada para https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages Observação: os dados do chat_gpt estão disponíveis apenas em inglês
- limit
  Tipo: integer
  
  o número máximo de objetos retornados campo opcional valor padrão: 100 valor máximo: 1000
- location_code
  Tipo: integer
  
  código do local de pesquisa campo opcional se você usar este campo, não precisa especificar location_name você pode obter a lista de locais disponíveis do mecanismo de busca e seus location_code fazendo uma requisição separada para https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages valor padrão: 2840 Observação: os dados do chat_gpt estão disponíveis apenas para 2840
- location_name
  Tipo: string
  
  nome completo do local de pesquisa campo opcional se você usar este campo, não precisa especificar location_code se você não especificar este campo, o location_code com valor 2840 será usado por padrão; você pode obter a lista de locais disponíveis do mecanismo de busca e seus location_name fazendo uma requisição separada para https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages Observação: os dados do chat_gpt estão disponíveis apenas para Estados Unidos
- offset
  Tipo: integer
  
  deslocamento no array de resultados dos dados de menções retornados campo opcional valor padrão: 0 exemplo: se você especificar o valor 10, os dez primeiros objetos de menções no array de resultados serão omitidos e os dados serão fornecidos para os objetos seguintes; Observação: o valor máximo é 9.000, use search_after_token se quiser deslocar mais resultados
- order_by
  Tipo: array string[]
  
  regras de ordenação dos resultados campo opcional você pode usar os mesmos valores do array filters para ordenar os resultados tipos de ordenação possíveis: asc - os resultados serão ordenados em ordem crescente desc - os resultados serão ordenados em ordem decrescente você deve usar uma vírgula para definir um tipo de ordenação exemplo: ["ai_search_volume,desc"] note que você pode definir no máximo três regras de ordenação em uma única requisição você deve usar uma vírgula para separar várias regras de ordenação
- platform
  Tipo: string
  
  plataforma de destino campo opcional valores possíveis: chat_gpt, google valor padrão: google Observação: os dados retornados dependem da plataforma selecionada Observação nº 2: os dados do chat_gpt estão disponíveis apenas para os Estados Unidos e o inglês
- search_after_token
  Tipo: string
  
  token para requisições subsequentes campo opcional fornecido no campo identical da resposta a cada requisição; use este parâmetro para evitar timeouts ao tentar obter mais de 20.000 resultados em uma única requisição; especificando o valor exclusivo search_after_token do array de resposta, você obterá os resultados subsequentes da tarefa inicial; os valores de search_after_token são exclusivos para cada tarefa subsequente ; Observação: se o search_after_token for especificado na requisição, todos os outros parâmetros devem ser idênticos aos da requisição anterior
- tag
  Tipo: string
  
  identificador de tarefa definido pelo usuário campo opcional o limite de caracteres é 255 você pode usar este parâmetro para identificar a tarefa e associá-la ao resultado você encontrará o valor tag especificado no objeto data da resposta

Respostas

200
Tipo: object

Resposta bem-sucedida
cost
Tipo: number

custo total das tarefas, USD

status_code
Tipo: integer

código de status geral você pode encontrar a lista completa dos códigos de resposta aqui Observação: recomendamos fortemente projetar um sistema necessário para lidar com condições excepcionais ou de erro relacionadas

status_message
Tipo: string

mensagem informativa geral você pode encontrar a lista completa das mensagens informativas gerais aqui

tasks
Tipo: array string[]

array de tarefas

tasks_count
Tipo: integer

o número de tarefas no array de tarefas

tasks_error
Tipo: integer

o número de tarefas no array de tarefas retornadas com erro

tasks.cost
Tipo: number

custo da tarefa, USD

tasks.data
Tipo: object

contém os mesmos parâmetros que você especificou na requisição POST

tasks.id
Tipo: string

identificador da tarefa identificador exclusivo da tarefa em nosso sistema no formato UUID

tasks.path
Tipo: array string[]

caminho da URL

tasks.result
Tipo: array string[]

array de resultados

tasks.result_count
Tipo: integer

número de elementos no array de resultados

tasks.result.current_offset
Tipo: integer

o número de objetos de menções omitidos no array items

tasks.result.items
Tipo: array string[]

contém dados de menções relevantes

tasks.result.items_count
Tipo: integer

o número de resultados retornados no array items

tasks.result.items.ai_search_volume
Tipo: integer

taxa atual de volume de pesquisa de IA de uma palavra-chave saiba mais sobre esta métrica aqui

tasks.result.items.answer
Tipo: string

resposta relevante em formato markdown conteúdo do resultado formatado na linguagem de marcação markdown

tasks.result.items.brand_entities
Tipo: array string[]

array de entidades de marca contém informações sobre marcas mencionadas na resposta

tasks.result.items.brand_entities.category
Tipo: string

categoria da marca

tasks.result.items.brand_entities.position
Tipo: integer

posição nos resultados

tasks.result.items.brand_entities.title
Tipo: string

nome da marca

tasks.result.items.fan_out_queries
Tipo: array string[]

array de consultas derivadas contém consultas de pesquisa relacionadas derivadas da consulta principal para fornecer uma resposta mais abrangente

tasks.result.items.first_response_at
Tipo: string

data e hora em que os dados da resposta foram registrados pela primeira vez no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” exemplo: 2025-10-21 06:25:30 +00:00

tasks.result.items.language_code
Tipo: string

código de idioma em um array POST

tasks.result.items.last_response_at
Tipo: string

data e hora da última atualização dos dados da resposta no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” exemplo: 2025-10-21 06:25:30 +00:00

tasks.result.items.location_code
Tipo: integer

código de localização em um array POST

tasks.result.items.model_name
Tipo: string

nome do modelo de IA do qual os dados foram recuperados Observação: para o tipo de plataforma google, o valor é sempre google_ai_overview

tasks.result.items.monthly_searches
Tipo: array string[]

taxas mensais de volume de pesquisa de IA array de objetos com taxas de volume de pesquisa de IA em um determinado mês do ano

tasks.result.items.monthly_searches.month
Tipo: integer

mês

tasks.result.items.monthly_searches.search_volume
Tipo: integer

taxa de volume de pesquisa de IA em um determinado mês do ano saiba mais sobre esta métrica aqui

tasks.result.items.monthly_searches.year
Tipo: integer

ano

tasks.result.items.platform
Tipo: string

plataforma recebida em um array POST

tasks.result.items.question
Tipo: string

pergunta relevante

tasks.result.items.search_results
Tipo: array string[]

array de resultados de pesquisa todas as saídas de pesquisa na web que o modelo recuperou ao buscar informações, incluindo duplicatas e entradas não utilizadas

tasks.result.items.search_results.breadcrumb
Tipo: string

trilha de navegação

tasks.result.items.search_results.description
Tipo: string

descrição do resultado

tasks.result.items.search_results.domain
Tipo: string

domínio do resultado

tasks.result.items.search_results.position
Tipo: integer

posição nos resultados

tasks.result.items.search_results.publication_date
Tipo: string

data e hora em que o resultado foi publicado no formato: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” exemplo: 2019-11-15 12:57:46 +00:00

tasks.result.items.search_results.title
Tipo: string

título do resultado

tasks.result.items.search_results.url
Tipo: string

URL do resultado

tasks.result.items.sources
Tipo: array string[]

array de origens as origens que o modelo citou ou usou como base em sua resposta final

tasks.result.items.sources.domain
Tipo: string

domínio de origem

tasks.result.items.sources.markdown
Tipo: string

conteúdo do elemento em formato markdown conteúdo do resultado formatado na linguagem de marcação markdown

tasks.result.items.sources.position
Tipo: integer

posição nos resultados

tasks.result.items.sources.publication_date
Tipo: string

data e hora em que o resultado foi publicado no formato: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” exemplo: 2019-11-15 12:57:46 +00:00

tasks.result.items.sources.snippet
Tipo: string

descrição da origem

tasks.result.items.sources.source_name
Tipo: string

nome da origem

tasks.result.items.sources.thumbnail
Tipo: string

miniatura da origem

tasks.result.items.sources.title
Tipo: string

título da origem

tasks.result.items.sources.url
Tipo: string

URL da origem

tasks.result.search_after_token
Tipo: string

token para requisições subsequentes ao definir uma nova tarefa com o search_after_token exclusivo, você obterá os resultados subsequentes da tarefa inicial; os valores de search_after_token são exclusivos para cada tarefa subsequente

tasks.result.total_count
Tipo: integer

quantidade total de resultados relevantes para a requisição

tasks.status_code
Tipo: integer

código de status da tarefa gerado pelo DataForSEO; pode estar no seguinte intervalo: 10000-60000 você pode encontrar a lista completa dos códigos de resposta aqui

tasks.status_message
Tipo: string

mensagem informativa da tarefa você pode encontrar a lista completa das mensagens informativas gerais aqui

tasks.time
Tipo: string

tempo de execução, segundos

time
Tipo: string

tempo de execução, segundos

version
Tipo: string

a versão atual da API
application/json
400

Não foi possível processar a requisição. Verifique os parâmetros da requisição.
401

É necessária uma chave de API da Felo válida.
402

A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.
403

A conta não tem permissão para realizar esta operação.
429

Um limite de requisições ou de gastos foi atingido.
502

O serviço não pôde concluir a requisição.
503

A API ou o serviço de cobrança está temporariamente indisponível.
504

O serviço atingiu o tempo limite ao processar a requisição.
default

Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor

application/json

post/v1/beta/dataforseo/ai_optimization/llm_mentions/search/live

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/llm_mentions/search/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": [
      {}
    ],
    "location_name": "",
    "location_code": 1,
    "language_name": "",
    "language_code": "",
    "platform": "",
    "filters": [],
    "order_by": [
      ""
    ],
    "offset": 1,
    "search_after_token": "",
    "limit": 1,
    "tag": ""
  }
]'

Mostrar Schema

{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "tasks.result": [
    "string"
  ],
  "tasks.result.total_count": 1,
  "tasks.result.current_offset": 1,
  "tasks.result.search_after_token": "string",
  "tasks.result.items_count": 1,
  "tasks.result.items": [
    "string"
  ],
  "tasks.result.items.platform": "string",
  "tasks.result.items.model_name": "string",
  "tasks.result.items.location_code": 1,
  "tasks.result.items.language_code": "string",
  "tasks.result.items.question": "string",
  "tasks.result.items.answer": "string",
  "tasks.result.items.sources": [
    "string"
  ],
  "tasks.result.items.sources.snippet": "string",
  "tasks.result.items.sources.source_name": "string",
  "tasks.result.items.sources.thumbnail": "string",
  "tasks.result.items.sources.markdown": "string",
  "tasks.result.items.sources.position": 1,
  "tasks.result.items.sources.title": "string",
  "tasks.result.items.sources.domain": "string",
  "tasks.result.items.sources.url": "string",
  "tasks.result.items.sources.publication_date": "string",
  "tasks.result.items.search_results": [
    "string"
  ],
  "tasks.result.items.search_results.description": "string",
  "tasks.result.items.search_results.breadcrumb": "string",
  "tasks.result.items.search_results.position": 1,
  "tasks.result.items.search_results.title": "string",
  "tasks.result.items.search_results.domain": "string",
  "tasks.result.items.search_results.url": "string",
  "tasks.result.items.search_results.publication_date": "string",
  "tasks.result.items.ai_search_volume": 1,
  "tasks.result.items.monthly_searches": [
    "string"
  ],
  "tasks.result.items.monthly_searches.year": 1,
  "tasks.result.items.monthly_searches.month": 1,
  "tasks.result.items.monthly_searches.search_volume": 1,
  "tasks.result.items.first_response_at": "string",
  "tasks.result.items.last_response_at": "string",
  "tasks.result.items.brand_entities": [
    "string"
  ],
  "tasks.result.items.brand_entities.position": 1,
  "tasks.result.items.brand_entities.title": "string",
  "tasks.result.items.brand_entities.category": "string",
  "tasks.result.items.fan_out_queries": [
    "string"
  ]
}

Resposta bem-sucedida

LLM Mentions em tempo real

AutenticaçãoRequired

DataForSEO

LLM Mentions em tempo real

Referência de preços