Content Analysis – API de distribución por valoración
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Content Analysis – API de distribución por valoración
Divide las citas de una palabra clave en intervalos de valoración e informa el conjunto completo de métricas para cada uno. Devuelve una entrada por intervalo con min, max y un objeto metrics que contiene 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. rank_scale elige el agrupamiento. Para las mismas métricas sin agrupar, usa post_dataforseo_content_summary_live; solo para el sentimiento, post_dataforseo_content_sentiment_analysis_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)[]
- 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" - positiveTipo: number | null
_connotation _threshold umbral de connotación positiva
campo opcional
se especifica como el umbral del índice de probabilidad de sentimiento positivo relacionado con el contenido de la cita
si especificas este campo, el objetoconnotation_typesde la respuesta solo contendrá datos de citas con una probabilidad de sentimientopositivemayor o igual al valor especificado
valores posibles: de0a1
valor predeterminado:0.4 - 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 todas las citas de lakeywordde destinoone_per_domain- devuelve una cita de lakeywordpor dominio
valor predeterminado:as_is - sentimentsTipo: number | null
_connotation _threshold umbral de connotación de sentimiento
campo opcional
se especifica como el umbral del índice de probabilidad de connotaciones de sentimiento relacionadas con el contenido de la cita
si especificas este campo, el objetosentiment_connotationsde la respuesta solo contendrá datos de citas en las que la probabilidad de cada sentimiento sea mayor o igual al valor especificado
valores posibles: de0a1
valor predeterminado:0.4 - 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_ContentAnalysisRatingDistributionLiveResponseInfo200
- 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_ContentAnalysisRatingDistributionLiveTaskInfo
- 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
- maxTipo: number | null
valoración máxima en una escala de distribución
- metricsTipo: object | null · Response36Afe1097B20_ContentAnalysisSummaryInfo
contiene métricas de distribución de valoraciones
- 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 de sentimiento 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).
- 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 - 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 de sentimiento 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 cantidad total de resultados de nuestra base de datos relevantes para tu solicitud
- typeTipo: string | null
tipo de elemento
- minTipo: number | null
valoración mínima en una escala de distribución
- 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/rating_distribution/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "logitech",
"search_mode": "as_is",
"internal_list_limit": 10
}
]'
{
"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,
"min": null,
"max": null,
"metrics": {
"type": null,
"total_count": null,
"rank": null,
"top_domains": [
"[Max Depth Exceeded]"
],
"sentiment_connotations": null,
"connotation_types": null,
"text_categories": [
"[Max Depth Exceeded]"
],
"page_categories": [
"[Max Depth Exceeded]"
],
"page_types": null,
"countries": null,
"languages": null
}
}
]
}
]
}