DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Resumen de la API OnPage
El estado y las métricas principales de un rastreo, por id. Devuelve crawl_progress, crawl_status, crawl_gateway_address, crawl_stop_reason, domain_info y page_metrics. 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. También es la forma de saber que un rastreo ha terminado: haz polling hasta que crawl_progress sea finished antes de leer cualquier otro endpoint de esta familia, o leerás resultados parciales que parecen reales. 💰 Gratis en el upstream: consultar un rastreo finalizado no cuesta nada; solo cuesta el rastreo en sí.
Referencia de precios
- Medición: Costo de respuesta reportado.
- Estimación de referencia por solicitud: USD 0.012.
- 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: object | null · Response36Afe1097B20_OnPageSummaryResponseInfo200
- 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_OnPageSummaryTaskInfo
- 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
- crawlTipo: string | null
_gateway _address - crawlTipo: string | null
_progress estado de la sesión de rastreo
valores posibles:in_progress,finished - crawlTipo: object | null · Response36Afe1097B20_CrawlStatusInfo
_status detalles de la sesión de rastreo
- maxTipo: integer | null Formato: int64
_crawl _pages número máximo de páginas que se pueden rastrear indica el límite max_crawl_pages que especificaste al configurar una tarea
- pagesTipo: integer | null Formato: int64
_crawled número de páginas rastreadas
- pagesTipo: integer | null Formato: int64
_in _queue número de páginas que están actualmente en la cola de rastreo
- crawlTipo: string | null
_stop _reason motivo por el que se detuvo el rastreo
información sobre el motivo por el que se detuvo el proceso de rastreo;
valores posibles:limit_exceeded- se superó el límite definido enmax_crawl_pages;empty_queue- se rastrearon todas las URL de la cola;force_stopped- el proceso de rastreo se detuvo con la función On Page API Force Stop;unexpected_exception- se encontró un error interno durante el rastreo deltarget, contacta con el soporte para obtener más información - domainTipo: object | null · Response36Afe1097B20_DomainInfo
_info información de todo el dominio
información on-page sobre el dominio de destino y el proceso de rastreo- canonicalizationTipo: integer | null
_status _code código de estado devuelto por una página canonicalizada
la comprobación del comportamiento del servidor cuando nuestro rastreador intenta acceder al sitio web mediante IP;
en la mayoría de los casos, se recomienda que las páginas canonicalizadas respondan con un código de estado301o302 - checksTipo: object | null
comprobaciones del sitio web
otras comprobaciones en la página relacionadas con el sitio web- propertyTipo: boolean | null
Name
- cmsTipo: string | null
sistema de gestión de contenido
sistema de gestión de contenido identificado en un sitio web
el contenido de la metaetiquetagenerator
los datos se toman de la primera página aleatoria que devuelve el código de respuesta 200
si nuestro rastreador no pudo identificar el CMS, el valor seríanulln - crawlTipo: string | null
_end hora en que finalizó el rastreo
fecha y hora en que se completó el rastreo
en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ejemplo:2019-11-15 12:57:46 +00:00
Nota: solo informativo si"crawl_progress"es"finished"
si"crawl_progress"esin_progress, el valor seránull - crawlTipo: string | null
_start hora en que comenzó el rastreo
fecha y hora en que el sitio web se envió para rastreo
en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ejemplo:2019-11-15 12:57:46 +00:00 - directoryTipo: integer | null
_browsing _status _code código de estado devuelto por un directorio
el código de estado devuelto por una página de directorio en un sitio web objetivo
en la mayoría de los casos, se recomienda que los directorios respondan con un código de estado403o401 - extendedTipo: string | null
_crawl _status estado y errores del rastreo
indica el motivo por el que un sitio web no se rastreó;
puede tomar los siguientes valores:no_errors- no se detectaron errores de rastreo;site_unreachable- nuestro rastreador no pudo acceder a un sitio web y, por lo tanto, no pudo obtener un código de estado;invalid_page_status_code- código de estado de la primera página rastreada >= 400;forbidden_meta_tag- la primera página rastreada contiene la etiqueta <meta robots="noindex">;forbidden_robots- robots.txt prohíbe el rastreo de la página;forbidden_http_header- el encabezado HTTP de la página contiene "X-Robots-Tag: noindex" ;too_many_redirects- la primera página rastreada tiene más de 10 redirecciones;unknown- el motivo es desconocido - ipTipo: string | null
dirección IP del dominio
- mainTipo: string | null
_domain nombre del dominio raíz
- nameTipo: string | null
nombre del dominio
- pageTipo: integer | null
_not _found _status _code código de estado devuelto por una página inexistente
en la mayoría de los casos, se recomienda que un servidor devuelva un código de respuesta 404 - serverTipo: string | null
servidor del sitio web
la versión del servidor detectada en un sitio web
el contenido del encabezadoserver
la información se toma de la primera página cuyo código de respuesta es 200 - sslTipo: object | null · Response36Afe1097B20_SslInfo
_info información del certificado SSL
información sobre el protocolo Secure Sockets Layer detectado en un sitio web- certificateTipo: string | null
_expiration _date fecha de expiración del certificado SSL
la fecha y hora en que expira el certificado SSL
en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ejemplo:2019-11-15 12:57:46 +00:00 - certificateTipo: string | null
_hash hash del certificado SSL
la versión de la función hash del certificado SSL - certificateTipo: string | null
_issuer autoridad del certificado SSL
la entidad que emitió el certificado SSL detectado - certificateTipo: string | null
_subject titular del certificado SSL
la entidad asociada a la clave pública - certificateTipo: integer | null
_version - validTipo: boolean | null
_certificate validez del certificado SSL
indica si el certificado SSL detectado en un sitio web no está caducado, suspendido, revocado ni es inválido
- totalTipo: integer | null Formato: int64
_pages total de páginas rastreadas
el número total de páginas rastreadas - totalTipo: integer | null Formato: int64
_uncrawlable _resources total de recursos no rastreables
el número total de recursos que no pudieron rastrearse;
el recurso se considera no rastreable cuando el tipo de contenido real del recurso no coincide con el tipo de contenido esperado por el rastreador - wwwTipo: integer | null
_redirect _status _code código de estado de la redirección
el código de estado de la redirección de www a no www
en la mayoría de los casos, se recomienda que la redirección devuelva un código de estado301
- pageTipo: object | null · Response36Afe1097B20_PageMetrics
_metrics información específica de la página
métricas de las páginas del sitio web de destino- brokenTipo: integer | null
_links número de enlaces rotos
número de enlaces rotos en todas las páginas rastreadas de un sitio web de destino - brokenTipo: integer | null
_resources número de recursos dañados
el número de imágenes y otros recursos con enlaces rotos - checksTipo: object | null
comprobaciones on-page específicas de la página
- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- duplicateTipo: integer | null
_content número de páginas con contenido duplicado
- duplicateTipo: integer | null
_description número de páginas con descripciones duplicadas
- duplicateTipo: integer | null
_title número de páginas con títulos duplicados
- linksTipo: integer | null
_external número de enlaces externos
el número de enlaces que apuntan a otros sitios web - linksTipo: integer | null
_internal número de enlaces internos
el número de enlaces que apuntan a otras páginas dentro del sitio web de destino - linksTipo: integer | null
_relation _conflict número de enlaces presentes en el sitio web de destino que pueden tener conflicto
por ejemplo, si"links_relation_conflict": 2, el sitio web de destino hace referencia a la misma fuente mediante al menos un enlace interno con el atributorel="nofollow"y mediante al menos un enlace dofollow - nonTipo: integer | null
_indexable - onpageTipo: number | null
_score muestra el grado de optimización del sitio web en una escala de 100 puntos
este campo muestra el grado de optimización del sitio web teniendo en cuenta los problemas críticos y las advertencias detectadas;100es la puntuación máxima posible, lo que significa que el sitio web no tiene ningún problema crítico ni advertencia importante;
ten en cuenta que este valor depende del número de páginas rastreadas;
obtén más información sobre cómo se calcula la métrica en este artículo del centro de ayuda - redirectTipo: integer | null
_loop número de cadenas de redirección que empiezan y terminan en la misma URL
número de cadenas de redirección en las que la URL de destino redirige de vuelta a la URL original
- 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/on_page/summary/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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": [
{
"crawl_progress": null,
"crawl_status": {
"max_crawl_pages": null,
"pages_in_queue": null,
"pages_crawled": null
},
"crawl_gateway_address": null,
"crawl_stop_reason": null,
"domain_info": {
"name": null,
"cms": null,
"ip": null,
"server": null,
"crawl_start": null,
"crawl_end": null,
"extended_crawl_status": null,
"ssl_info": "[Max Depth Exceeded]",
"checks": null,
"total_pages": null,
"total_uncrawlable_resources": null,
"page_not_found_status_code": null,
"canonicalization_status_code": null,
"directory_browsing_status_code": null,
"www_redirect_status_code": null,
"main_domain": null
},
"page_metrics": {
"links_external": null,
"links_internal": null,
"duplicate_title": null,
"duplicate_description": null,
"duplicate_content": null,
"broken_links": null,
"broken_resources": null,
"links_relation_conflict": null,
"redirect_loop": null,
"onpage_score": null,
"non_indexable": null,
"checks": null
}
}
]
}
]
}