Content Analysis – API de tendencias de frases
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Content Analysis – API de tendencias de frases
Las métricas de resumen de una palabra clave, repetidas por período. Cada entrada incluye un date más total_count, rank, top_domains (cada uno con domain y count), sentiment_connotations (anger, happiness, love, sadness, share, fun), connotation_types (positive, negative, neutral), text_categories, page_categories, page_types, countries y languages. date_from, date_to y date_group (day, week, month) definen el intervalo y la granularidad. Úsalo para ver si las menciones de una frase suben o bajan; para un único punto en el tiempo, usa post_dataforseo_content_summary_live. Para seguir una categoría de producto completa en lugar de una frase, usa post_dataforseo_content_category_trends_live.
Referencia de precios
- Medición: Coste de la respuesta notificado.
- Estimación de referencia por solicitud: USD 0.0276.
- Multiplicador de referencia del cliente: 1.0. No volver a aplicarlo 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 | null)[]
- dateTipo: string
_from fecha de inicio del intervalo de tiempo
campo obligatorio
formato de fecha:"yyyy-mm-dd"
ejemplo:"2019-01-15" - dateTipo: string | null
_group intervalo de tiempo que se usará para agrupar los resultados
campo opcional
valor predeterminado:month
valores posibles:day,week,month - dateTipo: string | null
_to fecha de fin del intervalo de tiempo
campo opcional
si no especificas este campo, se usará la fecha de hoy de forma predeterminada
formato de fecha:"yyyy-mm-dd"
ejemplo:"2019-01-15" - initialTipo: array (object | null)[] | null
_dataset _filters parámetros de filtrado del conjunto de datos inicial
campo opcional
parámetros de filtrado iniciales que se aplican a los campos del endpoint Search;
puedes añadir varios filtros a la vez (máximo 8 filtros);
debes definir un operador lógicoand,orentre las condiciones;
se admiten los siguientes operadores:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like,has,has_not,match,not_match
puedes usar el operador%conlikeynot_likepara coincidir con cualquier cadena de cero o más caracteres;
ejemplo:["domain","<>", "logitech.com"][["domain","<>","logitech.com"],"and",["content_info.connotation_types.negative",">",1000]][["domain","<>","logitech.com"]],
"and",
[["content_info.connotation_types.negative",">",1000],
"or",["content_info.text_category","has",10994]]]
para obtener más información sobre los filtros, consulta Content Analysis API - Filters
obtén más información sobre los filtros del conjunto de datos inicial en este artículo del Centro de ayuda.Objeto vacío - internalTipo: integer | null
_list _limit número máximo de elementos dentro de los arrays internos
campo opcional
puedes usar este campo para limitar el número de elementos de los siguientes arrays:top_domainstext_categoriespage_categoriescountrieslanguages
valor predeterminado:1
valor máximo:20 - keywordTipo: string
palabra clave de destino
campo obligatorio
codificación UTF-8
las palabras clave se convertirán a formato minúsculo;
Nota: para coincidir con una frase exacta en lugar de una palabra clave aislada, usa comillas dobles y barras invertidas;
ejemplo:"keyword": ""tesla palo alto""obtén más información sobre las reglas y limitaciones de los campos
keywordykeywordsen las API de DataForSEO en este artículo del Centro de ayuda - keywordTipo: object | null
_fields campos de palabra clave de destino y palabras clave de destino
campo opcional
usa este parámetro para filtrar el conjunto de datos por las palabras clave que deben contener determinados campos;
campos que puedes especificar:title,main_title,previous_title,snippet
puedes indicar varios campos;
Nota: para coincidir con una frase exacta en lugar de una palabra clave aislada, usa comillas dobles y barras invertidas;
ejemplo:"keyword_fields": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}"- propertyTipo: string | null
Name
- pageTipo: array string[] | null
_type tipos de página de destino
campo opcional
usa este parámetro para filtrar el conjunto de datos por tipos de página
valores posibles:"ecommerce","news","blogs","message-boards","organization" - rankTipo: string | null
_scale define la escala usada para calcular y mostrar los valores de
rank
campo opcionalpuedes usar este parámetro para elegir si los valores de rank se presentan en una escala de 0–100 o de 0–1000
valores posibles:
one_hundred— los valores de rank se muestran en una escala de 0–100one_thousand— los valores de rank se muestran en una escala de 0–1000valor predeterminado:
one_thousandobtén más información sobre cómo funciona este parámetro en este artículo del Centro de ayuda
- searchTipo: string | null
_mode tipo de agrupación de los resultados
campo opcional
tipos de agrupación posibles:as_is- devuelve datos de todas las citas de lakeywordde destinoone_per_domain- devuelve datos de una cita de lakeywordpor dominio
valor predeterminado:as_is - tagTipo: string | null
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 detagespecificado en el objetodatade la respuesta
- Tipo: object | null · Response36Afe1097B20_ContentAnalysisPhraseTrendsLiveResponseInfo200
- Tipo: number | null Formato: doublecost
costo total de las tareas, USD
- Tipo: integer | nullstatus
_code código de estado general puedes encontrar la lista completa de los códigos de respuesta aquí
- Tipo: string | nullstatus
_message mensaje informativo general puedes encontrar la lista completa de los mensajes informativos generales aquí
- Tipo: array (object | null)[] | nulltasks
array de tareas
- Tipo: object | null · Response36Afe1097B20_ContentAnalysisPhraseTrendsLiveTaskInfo
- costTipo: number | null Formato: double
costo total de las tareas, USD
- dataTipo: object | null
contiene los mismos parámetros que especificaste en la solicitud POST
- propertyTipo: object | null
Name
- idTipo: string | null
identificador de la tarea identificador único de la tarea en nuestro sistema en formato UUID
- pathTipo: array (string | null)[] | null
ruta de la URL
- resultTipo: array (object | null)[] | null
array de resultados
- connotationTipo: object | null
_types tipos de connotación
contiene los tipos de sentimientos (polaridad del sentimiento) relacionados con la cita de la palabra clave y el recuento de citas por cada tipo de sentimiento
tipos de connotación posibles:"positive","negative","neutral"- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- countriesTipo: object | null
- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- dateTipo: string | null
fecha para la que se proporcionan los datos
- languagesTipo: object | null
- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- pageTipo: array (object | null)[] | null
_categories - categoryTipo: array (integer | null)[] | null
- countTipo: integer | null Formato: int64
Signed 64-bit integers (long type).
- pageTipo: object | null
_types tipos de página
contiene tipos de página y el recuento de citas por cada tipo de página- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- rankTipo: integer | null
ranking de todas las URL que citan la
keyword
suma normalizada de los rankings de todas las URL que citan lakeywordde destino para la fecha dada - sentimentTipo: object | null
_connotations connotaciones de sentimiento
contiene los sentimientos (reacciones emocionales) relacionados con la cita de la palabra clave de destino y el número de citas por cada sentimiento
connotaciones posibles:"anger","happiness","love","sadness","share","fun"- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- textTipo: array (object | null)[] | null
_categories - categoryTipo: array (integer | null)[] | null
- countTipo: integer | null Formato: int64
Signed 64-bit integers (long type).
- topTipo: array (object | null)[] | null
_domains principales dominios que citan la palabra clave de destino
contiene objetos con los principales dominios que citan la palabra clave de destino y el recuento de citas por cada dominio- countTipo: integer | null Formato: int64
Signed 64-bit integers (long type).
- domainTipo: string | null
- totalTipo: integer | null Formato: int64
_count número total de resultados de nuestra base de datos relevantes para tu solicitud
- typeTipo: string | null
tipo de elemento
- resultTipo: integer | null Formato: int64
_count número de elementos en el array de resultados
- statusTipo: integer | null
_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í
- statusTipo: string | null
_message mensaje informativo de la tarea puedes encontrar la lista completa de los mensajes informativos generales aquí
- timeTipo: string | null
tiempo de ejecución, segundos
- Tipo: integer | null Formato: int64tasks
_count el número de tareas en el array de tareas
- Tipo: integer | null Formato: int64tasks
_error el número de tareas en el array de tareas devueltas con un error
- Tipo: string | nulltime
tiempo total de ejecución, en segundos
- Tipo: string | nullversion
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/content_analysis/phrase_trends/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "logitech",
"search_mode": "as_is",
"date_from": "2022-09-01",
"date_group": "month"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"type": null,
"date": null,
"total_count": null,
"rank": null,
"top_domains": [
{
"domain": null,
"count": null
}
],
"sentiment_connotations": null,
"connotation_types": null,
"text_categories": [
{
"category": [
"[Max Depth Exceeded]"
],
"count": null
}
],
"page_categories": [
{
"category": [
"[Max Depth Exceeded]"
],
"count": null
}
],
"page_types": null,
"countries": null,
"languages": null
}
]
}
]
}