DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
LLM Mentions en tiempo real
Las respuestas individuales en las que un asistente mencionó tu objetivo. Devuelve total_count, current_offset, search_after_token y items; pagina con el token, no con offset, a partir de las primeras páginas. ⚠️ target es un array de objetos, cada uno {"domain": "..."} o {"keyword": "..."}; una cadena simple se rechaza por tipo incorrecto y un array de cadenas con 'Each target item must be an object'. Los campos de filtro proceden de get_dataforseo_ai_llm_mentions_available_filters. Envuelto en el sobre de DataForSEO: los datos en tasks[0].result, el resultado en tasks[0].status_code; una solicitud rechazada sigue devolviendo HTTP 200. Para recuentos en lugar de las menciones en sí, usa post_dataforseo_ai_llm_mentions_aggregated_metrics_live.
Referencia de precios
- Medición: Costo de respuesta reportado.
- Estimación de referencia por solicitud: USD 0.701.
- Multiplicador de referencia del cliente: 1.0. No lo apliques de nuevo a un importe de cliente ya liquidado.
Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.
- Tipo: array object[]
- targetTipo: array object[]obligatorio
array de objetos que contienen entidades de destino campo obligatorio puedes especificar hasta 10 entidades (objetos) en el campo target una entidad de destino puede contener un dominio o una palabra clave y parámetros relacionados. Ejemplos: array targets con una entidad de dominio [{"domain": "en.wikipedia.org", "search_filter": "exclude"}] array targets con una entidad de palabra clave [{"keyword": "bmw", "search_scope": ["question"], "match_type ": "partial_match"}] array targets con varias entidades [{"domain": "en.wikipedia.org", "search_filter": "exclude"}, {"keyword": "bmw", "match_type ": "partial_match", "search_scope": ["answer"]}]
- domainTipo: stringobligatorio
dominio de destino campo obligatorio si no especificas keyword puedes especificar hasta 63 caracteres en el campo domain; un dominio debe especificarse sin https:// ni www.
- includeTipo: boolean
_subdomains indica si los subdominios del dominio de destino se incluirán en la búsqueda campo opcional si se establece en true, los subdominios se incluirán en la búsqueda valor predeterminado: false
- keywordTipo: string
palabra clave de destino campo obligatorio si no especificas domain puedes especificar hasta 250 caracteres en el campo keyword todos los %## se decodificarán (el carácter ‘+’ se decodificará como un espacio) si necesitas usar el carácter “%” en tu keyword, especifícalo como “%25”; si necesitas usar el carácter “+” en tu keyword, especifícalo como “%2B”más información sobre las reglas y limitaciones de los campos keyword y keywords en las API de DataForSEO en este artículo del Centro de ayuda
- matchTipo: string
_type tipo de coincidencia de la palabra clave de destino define cómo se compara la palabra clave especificada campo opcional valores posibles: word_match - búsqueda de texto completo de términos que coinciden con la palabra clave semilla especificada, con palabras adicionales incluidas antes, después o dentro de la frase clave (por ejemplo, una búsqueda de "light" devolverá resultados con "light bulb", "light switch"); partial_match - búsqueda de subcadenas que encuentra todas las apariciones de la secuencia de caracteres especificada, aunque aparezca dentro de una palabra más larga (por ejemplo, una búsqueda de "light" devolverá resultados con "lighting", "highlight"); valor predeterminado: word_match
- searchTipo: string
_filter Filtro de búsqueda de entidades: incluir o excluir; el valor predeterminado es incluir.
- searchTipo: array string[]
_scope Ámbito de búsqueda. Entidades de dominio: any, sources, search_results. Entidades de palabra clave: any, question, answer, brand_entities, fan_out_queries. Valor predeterminado: any.
- filtersTipo: array
array de parámetros de filtrado de resultados campo opcional puedes añadir varios filtros a la vez (máximo 8 filtros) debes definir un operador lógico and, or entre las condiciones se admiten los siguientes operadores: =, in, not_in, like, not_like, ilike, not_ilike, match, not_match puedes usar el operador % con like y not_like para coincidir con cualquier cadena de cero o más caracteres ejemplo: ["ai_search_volume",">","1000"] La lista completa de filtros posibles está disponible aquí.
- languageTipo: string
_code código de idioma de búsqueda campo opcional si usas este campo, no necesitas especificar language_name; puedes obtener la lista de idiomas disponibles del motor de búsqueda y su language_code haciendo una solicitud independiente a https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages valor predeterminado: en Nota: los datos de chat_gpt solo están disponibles para en
- languageTipo: string
_name nombre completo del idioma de búsqueda campo opcional si usas este campo, no necesitas especificar language_code; si no especificas este campo, se usará por defecto el language_code con valor en; puedes obtener la lista de idiomas disponibles del motor de búsqueda y su language_name haciendo una solicitud independiente a https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages Nota: los datos de chat_gpt solo están disponibles en inglés
- limitTipo: integer
el número máximo de objetos devueltos campo opcional valor predeterminado: 100 valor máximo: 1000
- locationTipo: integer
_code código de ubicación de búsqueda campo opcional si usas este campo, no necesitas especificar location_name puedes obtener la lista de ubicaciones disponibles del motor de búsqueda y su location_code haciendo una solicitud independiente a https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages valor predeterminado: 2840 Nota: los datos de chat_gpt solo están disponibles para 2840
- locationTipo: string
_name nombre completo de la ubicación de búsqueda campo opcional si usas este campo, no necesitas especificar location_code si no especificas este campo, se usará por defecto el location_code con valor 2840; puedes obtener la lista de ubicaciones disponibles del motor de búsqueda y su location_name haciendo una solicitud independiente a https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages Nota: los datos de chat_gpt solo están disponibles para Estados Unidos
- offsetTipo: integer
desplazamiento en el array de resultados de los datos de menciones devueltos campo opcional valor predeterminado: 0 ejemplo: si especificas el valor 10, los diez primeros objetos de menciones del array de resultados se omitirán y los datos se proporcionarán para los objetos siguientes; Nota: el valor máximo es 9.000, usa search_after_token si quieres desplazar más resultados
- orderTipo: array string[]
_by reglas de ordenación de los resultados campo opcional puedes usar los mismos valores que en el array filters para ordenar los resultados tipos de ordenación posibles: asc - los resultados se ordenarán en orden ascendente desc - los resultados se ordenarán en orden descendente debes usar una coma para definir un tipo de ordenación ejemplo: ["ai_search_volume,desc"] ten en cuenta que puedes definir como máximo tres reglas de ordenación en una sola solicitud debes usar una coma para separar varias reglas de ordenación
- platformTipo: string
plataforma de destino campo opcional valores posibles: chat_gpt, google valor predeterminado: google Nota: los datos devueltos dependen de la plataforma seleccionada Nota n.º 2: los datos de chat_gpt solo están disponibles para Estados Unidos y en inglés
- searchTipo: string
_after _token token para solicitudes posteriores campo opcional se proporciona en el campo identical de la respuesta a cada solicitud; usa este parámetro para evitar tiempos de espera al intentar obtener más de 20.000 resultados en una sola solicitud; al especificar el valor único search_after_token del array de respuesta, obtendrás los resultados posteriores de la tarea inicial; los valores de search_after_token son únicos para cada tarea posterior ; Nota: si se especifica search_after_token en la solicitud, todos los demás parámetros deben ser idénticos a los de la solicitud anterior
- tagTipo: string
identificador de tarea definido por el usuario campo opcional el límite de caracteres es 255 puedes usar este parámetro para identificar la tarea y relacionarla con el resultado encontrarás el valor tag especificado en el objeto data de la respuesta
- Tipo: object200
Respuesta correcta
- Tipo: numbercost
costo total de las tareas, USD
- Tipo: integerstatus
_code código de estado general puedes encontrar la lista completa de los códigos de respuesta aquí Nota: recomendamos encarecidamente diseñar un sistema para gestionar las condiciones excepcionales o de error relacionadas
- Tipo: stringstatus
_message mensaje informativo general puedes encontrar la lista completa de los mensajes informativos generales aquí
- Tipo: array string[]tasks
array de tareas
- Tipo: integertasks
_count el número de tareas en el array de tareas
- Tipo: integertasks
_error el número de tareas en el array de tareas devueltas con un error
- Tipo: numbertasks
.cost costo de la tarea, USD
- Tipo: objecttasks
.data contiene los mismos parámetros que especificaste en la solicitud POST
- Tipo: stringtasks
.id identificador de la tarea identificador único de la tarea en nuestro sistema en formato UUID
- Tipo: array string[]tasks
.path ruta de la URL
- Tipo: array string[]tasks
.result array de resultados
- Tipo: integertasks
.result _count número de elementos en el array de resultados
- Tipo: integertasks
.result .current _offset el número de objetos de menciones omitidos en el array items
- Tipo: array string[]tasks
.result .items contiene datos de menciones relevantes
- Tipo: integertasks
.result .items _count el número de resultados devueltos en el array items
- Tipo: integertasks
.result .items .ai _search _volume tasa actual de volumen de búsqueda de IA de una palabra clave más información sobre esta métrica aquí
- Tipo: stringtasks
.result .items .answer respuesta relevante en formato markdown contenido del resultado formateado en el lenguaje de marcado markdown
- Tipo: array string[]tasks
.result .items .brand _entities array de entidades de marca contiene información sobre las marcas mencionadas en la respuesta
- Tipo: stringtasks
.result .items .brand _entities .category categoría de la marca
- Tipo: integertasks
.result .items .brand _entities .position posición en los resultados
- Tipo: stringtasks
.result .items .brand _entities .title nombre de la marca
- Tipo: array string[]tasks
.result .items .fan _out _queries array de consultas derivadas contiene consultas de búsqueda relacionadas derivadas de la consulta principal para ofrecer una respuesta más completa
- Tipo: stringtasks
.result .items .first _response _at fecha y hora en que los datos de la respuesta se registraron por primera vez en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” ejemplo: 2025-10-21 06:25:30 +00:00
- Tipo: stringtasks
.result .items .language _code código de idioma en un array POST
- Tipo: stringtasks
.result .items .last _response _at fecha y hora de la última actualización de los datos de la respuesta en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” ejemplo: 2025-10-21 06:25:30 +00:00
- Tipo: integertasks
.result .items .location _code código de ubicación en un array POST
- Tipo: stringtasks
.result .items .model _name nombre del modelo de IA del que se recuperaron los datos Nota: para el tipo de plataforma google, el valor siempre es google_ai_overview
- Tipo: array string[]tasks
.result .items .monthly _searches tasas mensuales de volumen de búsqueda de IA array de objetos con las tasas de volumen de búsqueda de IA en un mes determinado del año
- Tipo: integertasks
.result .items .monthly _searches .month mes
- Tipo: integertasks
.result .items .monthly _searches .search _volume tasa de volumen de búsqueda de IA en un mes determinado del año obtén más información sobre esta métrica aquí
- Tipo: integertasks
.result .items .monthly _searches .year año
- Tipo: stringtasks
.result .items .platform plataforma recibida en un array POST
- Tipo: stringtasks
.result .items .question pregunta relevante
- Tipo: array string[]tasks
.result .items .search _results array de resultados de búsqueda todas las salidas de búsqueda web que el modelo recuperó al buscar información, incluidas las duplicadas y las entradas no utilizadas
- Tipo: string
ruta de navegación
- Tipo: stringtasks
.result .items .search _results .description descripción del resultado
- Tipo: stringtasks
.result .items .search _results .domain dominio del resultado
- Tipo: integertasks
.result .items .search _results .position posición en los resultados
- Tipo: stringtasks
.result .items .search _results .publication _date fecha y hora en que se publicó el resultado con el formato: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” ejemplo: 2019-11-15 12:57:46 +00:00
- Tipo: stringtasks
.result .items .search _results .title título del resultado
- Tipo: stringtasks
.result .items .search _results .url URL del resultado
- Tipo: array string[]tasks
.result .items .sources array de orígenes los orígenes que el modelo citó o utilizó en su respuesta final
- Tipo: stringtasks
.result .items .sources .domain dominio de origen
- Tipo: stringtasks
.result .items .sources .markdown contenido del elemento en formato markdown contenido del resultado formateado en el lenguaje de marcado markdown
- Tipo: integertasks
.result .items .sources .position posición en los resultados
- Tipo: stringtasks
.result .items .sources .publication _date fecha y hora en que se publicó el resultado con el formato: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” ejemplo: 2019-11-15 12:57:46 +00:00
- Tipo: stringtasks
.result .items .sources .snippet descripción del origen
- Tipo: stringtasks
.result .items .sources .source _name nombre del origen
- Tipo: stringtasks
.result .items .sources .thumbnail miniatura del origen
- Tipo: stringtasks
.result .items .sources .title título del origen
- Tipo: stringtasks
.result .items .sources .url URL del origen
- Tipo: stringtasks
.result .search _after _token token para solicitudes posteriores al definir una nueva tarea con el search_after_token único, obtendrás los resultados posteriores de la tarea inicial; los valores de search_after_token son únicos para cada tarea posterior
- Tipo: integertasks
.result .total _count cantidad total de resultados relevantes para la solicitud
- Tipo: integertasks
.status _code código de estado de la tarea generado por DataForSEO; puede estar dentro del siguiente intervalo: 10000-60000 puedes encontrar la lista completa de los códigos de respuesta aquí
- Tipo: stringtasks
.status _message mensaje informativo de la tarea puedes encontrar la lista completa de los mensajes informativos generales aquí
- Tipo: stringtasks
.time tiempo de ejecución, segundos
- Tipo: stringtime
tiempo de ejecución, segundos
- Tipo: stringversion
la versión actual de la API
application/json - 400
No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.
- 401
Se requiere una clave de API de Felo válida.
- 402
La solicitud no puede continuar porque no se cumple un requisito de facturación.
- 403
La cuenta no tiene permiso para realizar esta operación.
- 429
Se ha alcanzado un límite de solicitudes o de gasto.
- 502
El servicio no pudo completar la solicitud.
- 503
La API o el servicio de facturación no están disponibles temporalmente.
- 504
El servicio agotó el tiempo de espera al procesar la solicitud.
- default
Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor
application/json
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": ""
}
]'
{
"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"
]
}