v0.2.0-beta

OpenAPI 3.1.0

Configurar tareas de OnPage

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 Operaciones

post/v1/beta/dataforseo/on_page/task_post

Configurar tareas de OnPage

Inicia un rastreo de target y devuelve un id de tarea en tasks[0].id: ese id es la referencia que necesitan todas las demás herramientas de esta familia, así que guárdalo. max_crawl_pages limita el rastreo; start_url, max_crawl_depth, priority_urls y crawl_delay lo moldean; y store_raw_html decide si post_dataforseo_on_page_raw_html tendrá algo que servir después. 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. ⚠️ No es el par habitual de envío/consulta: el rastreo es una sesión que una docena de otras herramientas consulta después por id. Haz polling con get_dataforseo_on_page_summary hasta que crawl_progress indique finished; un rastreo de una página de example.com tardó bastante menos de un minuto.

Referencia de precios

Medición: Costo de respuesta reportado.
Estimación de referencia por solicitud: USD 0.003.
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.

Cuerpo

application/json

Tipo: array (object | null)[]
- accept_language
 Tipo: string | null
 
 encabezado de idioma para acceder al sitio web
 campo opcional
 se admiten todos los formatos de configuración regional (xx, xx-XX, xxx-XX, etc.)
 Nota: si no especificas este parámetro, algunos sitios web pueden denegar el acceso; en ese caso, las páginas se devolverán con "type":"broken en el array de respuesta
- allow_subdomains
 Tipo: boolean | null
 
 incluir páginas en subdominios
 campo opcional
 establécelo en true si quieres rastrear todos los subdominios de un sitio web de destino
 valor predeterminado: false
- allowed_subdomains
 Tipo: array string[] | null
 
 subdominios que se van a rastrear
 campo opcional
 especifica los subdominios que quieres rastrear
 ejemplo: ["blog.site.com", "my.site.com", "shop.site.com"]
 Nota: para usar este parámetro, el parámetro allow_subdomains debe establecerse en false;
 de lo contrario, el contenido del campo allowed_subdomains se ignorará y los resultados se devolverán para todos los subdominios
- browser_preset
 Tipo: string | null
 
 preajuste de los parámetros de pantalla del navegador
 campo opcional
 si usas este campo, no necesitas indicar browser_screen_width, browser_screen_height, browser_screen_scale_factorvalores posibles:
 desktop, mobile, tabletel preajuste desktop aplicará los siguientes valores:browser_screen_width: 1920
 browser_screen_height: 1080
 browser_screen_scale_factor: 1el preajuste mobile aplicará los siguientes valores:browser_screen_width: 390
 browser_screen_height: 844
 browser_screen_scale_factor: 3el preajuste tablet aplicará los siguientes valores:browser_screen_width: 1024
 browser_screen_height: 1366
 browser_screen_scale_factor: 2
 Nota: para usar este parámetro, establece enable_javascript o enable_browser_rendering en true
- browser_screen_height
 Tipo: integer | null
 
 altura de pantalla del navegador
 campo opcional
 puedes definir una altura de pantalla de navegador personalizada para realizar la auditoría de un dispositivo concreto;
 si usas este campo, no necesitas indicar browser_preset, ya que se ignorará;
 Nota: para usar este parámetro, establece enable_javascript o enable_browser_rendering en truevalor mínimo, en píxeles: 240
 valor máximo, en píxeles: 9999
- browser_screen_scale_factor
 Tipo: number | null
 
 factor de escala de pantalla del navegador
 campo opcional
 puedes definir una proporción de resolución de pantalla de navegador personalizada para realizar la auditoría de un dispositivo concreto;
 si usas este campo, no necesitas indicar browser_preset, ya que se ignorará;
 Nota: para usar este parámetro, establece enable_javascript o enable_browser_rendering en truevalor mínimo: 0.5
 valor máximo: 3
- browser_screen_width
 Tipo: integer | null Formato: int64
 
 anchura de pantalla del navegador
 campo opcional
 puedes definir una anchura de pantalla de navegador personalizada para realizar la auditoría de un dispositivo concreto;
 si usas este campo, no necesitas indicar browser_preset, ya que se ignorará;
 Nota: para usar este parámetro, establece enable_javascript o enable_browser_rendering en truevalor mínimo, en píxeles: 240
 valor máximo, en píxeles: 9999
- calculate_keyword_density
 Tipo: boolean | null
 
 calcular la densidad de palabras clave para el dominio de destino
 campo opcional
 establécelo en true si quieres calcular la densidad de palabras clave de las páginas del sitio web
 valor predeterminado: false
 Nota: si usas este parámetro, se aplicarán cargos adicionales; obtén más información sobre el costo de las tareas con este parámetro en nuestro artículo de ayuda
 cuando finalice el rastreo, podrás obtener los valores de densidad de palabras clave con el endpoint Keyword Density
- check_spell
 Tipo: boolean | null
 
 comprobar la ortografía
 campo opcional
 establécelo en true para comprobar la ortografía de un sitio web usando la biblioteca Hunspell
 valor predeterminado: false
- check_spell_exceptions
 Tipo: array string[] | null
 
 palabras excluidas de la corrección ortográfica
 campo opcional
 especifica las palabras que quieres excluir de la corrección ortográfica
 longitud máxima de palabra: 100 caracteres
 cantidad máxima de palabras: 1000
 ejemplo: "SERP", "minifiers", "JavaScript"
- check_spell_language
 Tipo: string | null
 
 idioma de la corrección ortográfica
 campo opcional
 idiomas admitidos: 'hy', 'eu', 'bg', 'ca', 'hr', 'cs', 'da', 'nl', 'en', 'eo', 'et', 'fo', 'fa', 'fr', 'fy', 'gl', 'ka', 'de', 'el', 'he', 'hu', 'is', 'ia', 'ga', 'it', 'rw', 'la', 'lv', 'lt', 'mk', 'mn', 'ne', 'nb', 'nn', 'pl', 'pt', 'ro', 'gd', 'sr', 'sk', 'sl', 'es', 'sv', 'tr', 'tk', 'uk', 'vi'
 Nota: si no se especifica ningún idioma, se establecerá automáticamente según el contenido de la página
- checks_threshold
 Tipo: object | null
 
 valores de umbral personalizados para las comprobaciones
 campo opcional
 puedes especificar valores de umbral personalizados para los parámetros incluidos en el objeto checks de las respuestas de la API OnPage;
 Nota: solo se pueden modificar los valores de umbral enteros;
 por ejemplo, los parámetros high_loading_time y large_page_size se establecen en 3 segundos y 1 megabyte respectivamente de forma predeterminada;
 si quieres cambiar estos umbrales a 1 segundo y 1000 kbytes, usa el siguiente fragmento:
 "checks_threshold": { "high_loading_time": 1, "large_page_size": 1000 }
 parámetros personalizables disponibles con valores predeterminados:
 "title_too_short", default value: 30, type: "int" "title_too_long", default value: 65, type: "int" "small_page_size", default value: 1024, type: "int" "large_page_size", default value: 1048576 (1024 * 1024), type: "int" "low_character_count", default value: 1024, type: "int" "high_character_count", default value: 256000 (250 * 1024), type: "int" "low_content_rate", default value: 0.1, type: "float" "high_content_rate", default value: 0.9, type: "float" "high_loading_time", default value: 3000, type: "int" "high_waiting_time", default value: 1500, type: "int" "low_readability_rate", default value: 15.0, type: "float" "irrelevant_description", default value: 0.2, type: "float" "irrelevant_title", default value: 0.3, type: "float" "irrelevant_meta_keywords", default value: 0.6, type: "float"
 
 propertyName
 Tipo: integer | null Formato: int64
 
 Signed 64-bit integers (long type).
- crawl_delay
 Tipo: integer | null
 
 retraso entre accesos, ms
 campo opcional
 el retraso personalizado entre los accesos del rastreador al servidor
 valor predeterminado: 2000
- crawl_sitemap_only
 Tipo: boolean | null
 
 rastrear solo las páginas indicadas en el sitemap
 campo opcional
 establécelo en true si quieres rastrear solo las páginas indicadas en el sitemap
 si estableces este parámetro en true y no especificas custom_sitemap, rastrearemos el sitemap predeterminado
 valor predeterminado: false
 Nota: para usar este parámetro, respect_sitemap debe ser true
- custom_js
 Tipo: string | null
 
 javascript personalizado
 campo opcional
 Nota: el tiempo de ejecución del script que introduzcas aquí debe ser de 700 ms como máximo; por ejemplo, puedes usar el siguiente fragmento de JS para comprobar si el sitio web contiene Google Tag Manager como atributo scr:
 let meta = { haveGoogleAnalytics: false, haveTagManager: false };rnfor (var i = 0; i < document.scripts.length; i++) {rn let src = document.scripts[i].getAttribute("src");rn if (src != undefined) {rn if (src.indexOf("analytics.js") >= 0)rn meta.haveGoogleAnalytics = true;rntif (src.indexOf("gtm.js") >= 0)rn meta.haveTagManager = true;rn }rn}rnmeta;El valor devuelto depende de lo que especifiques en este campo. Por ejemplo, si especificas el siguiente script:
 meta = {}; meta.url = document.URL; meta.test = 'test'; meta;
 como respuesta recibirás los siguientes datos:
 "custom_js_response": { "url": "https://dataforseo.com/", "test": "test" }
 Nota: la longitud del script que introduzcas no debe superar los 2000 caracteres
- custom_robots_txt
 Tipo: string | null
 
 configuración personalizada de robots.txt
 campo opcional
 ejemplo: Disallow: /directory1/
- custom_sitemap
 Tipo: string | null
 
 url del sitemap personalizado
 campo opcional
 la URL de la página donde se encuentra el sitemap alternativo
 Nota: para usar este parámetro, respect_sitemap debe ser true
- custom_user_agent
 Tipo: string | null
 
 user agent personalizado
 campo opcional
 user agent personalizado para rastrear un sitio web
 ejemplo: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36
 valor predeterminado: Mozilla/5.0 (compatible; RSiteAuditor)
- disable_cookie_popup
 Tipo: boolean | null
 
 desactivar la ventana emergente de cookies
 campo opcional
 establécelo en true si quieres desactivar la ventana emergente que solicita el consentimiento de cookies al usuario;
 valor predeterminado:
 false
- disable_page_checks
 Tipo: array string[] | null
 
 impedir la ejecución de determinadas comprobaciones de página
 campo opcional
 especifica determinados checks para impedir que se ejecuten y afecten al onpage_scoreejemplo:
 "disable_page_checks": ["is_5xx_code", "is_4xx_code"]
- disable_sitewide_checks
 Tipo: array string[] | null
 
 impedir la ejecución de determinadas comprobaciones en todo el sitio
 campo opcional
 especifica los siguientes checks para impedir que se ejecuten en el sitio web target:
 "test_page_not_found"
 "test_canonicalization"
 "test_https_redirect"
 "test_directory_browsing"ejemplo:
 "disable_sitewide_checks": ["test_directory_browsing", "test_page_not_found"]más información en nuestro Centro de ayuda
- disallowed_subdomains
 Tipo: array string[] | null
 
 subdominios que no se deben rastrear
 campo opcional
 especifica los subdominios que no quieres rastrear
 ejemplo: ["status.site.com", "docs.site.com"]
 Nota: para usar este parámetro, el parámetro allow_subdomains debe establecerse en true
- enable_browser_rendering
 Tipo: boolean | null
 
 emular el renderizado del navegador para medir Core Web Vitals
 campo opcional
 con este parámetro podrás emular un navegador al cargar una página web;
 enable_browser_rendering carga estilos, imágenes, fuentes, animaciones, vídeos y otros recursos de una página;
 valor predeterminado: false
 establécelo en true para obtener métricas de Core Web Vitals (FID, CLS, LCP) en la respuesta;
 si usas este campo, los parámetros enable_javascript y load_resources deben establecerse en true
 Nota: si usas este parámetro, se aplicarán cargos adicionales; obtén más información sobre el costo de las tareas con este parámetro en nuestro artículo de ayuda; el costo puede calcularse en la página de Precios
- enable_content_parsing
 Tipo: boolean | null
 
 analizar el contenido de las páginas rastreadas
 campo opcional
 establécelo en true para usar el endpoint OnPage Content Parsing
 valor predeterminado: false
- enable_javascript
 Tipo: boolean | null
 
 cargar javascript en una página
 campo opcional
 establécelo en true si quieres cargar los scripts disponibles en una página
 valor predeterminado: false
 Nota: si usas este parámetro, se aplicarán cargos adicionales; obtén más información sobre el costo de las tareas con este parámetro en nuestro artículo de ayuda; el costo puede calcularse en la página de Precios
- enable_www_redirect_check
 Tipo: boolean | null
 
 comprobar si el dominio implementó la redirección www
 campo opcional
 establécelo en true si quieres comprobar si el dominio solicitado implementó la redirección de www a no www o de no www a www;
 valor predeterminado: false
- enable_xhr
 Tipo: boolean | null
 
 habilitar XMLHttpRequest en una página
 campo opcional
 establécelo en true si quieres que nuestro rastreador solicite datos de un servidor web mediante el objeto XMLHttpRequest
 valor predeterminado: false;si usas este campo, enable_javascript debe establecerse en true;
- force_sitewide_checks
 Tipo: boolean | null
 
 habilitar comprobaciones en todo el sitio al rastrear una sola página
 campo opcional
 establécelo en true para obtener datos sobre las comprobaciones en todo el sitio al rastrear una sola página;
 valor predeterminado: false
- load_resources
 Tipo: boolean | null
 
 cargar recursos
 campo opcional
 establécelo en true si quieres cargar imágenes, hojas de estilo, scripts y recursos dañados
 valor predeterminado: false
 Nota: si usas este parámetro, se aplicarán cargos adicionales; obtén más información sobre el costo de las tareas con este parámetro en nuestro artículo de ayuda; el costo puede calcularse en la página de Precios
- max_crawl_depth
 Tipo: integer | null
 
 profundidad de rastreo
 campo opcional
 la profundidad de enlace de las páginas que se van a rastrear;
 por ejemplo, la página inicial del rastreo es el nivel 0, las páginas que tienen enlaces desde esa página son el nivel 1, etc.
- max_crawl_pages
 Tipo: integer
 
 límite de páginas rastreadas
 campo obligatorio
 el número de páginas que se van a rastrear en el dominio especificado
 Nota:
 si estableces max_crawl_pages en 1 y no especificas start_url o estableces una página de inicio en él, se desactivarán las siguientes comprobaciones en todo el sitio:
 test_canonicalization, enable_www_redirect_check, test_hidden_server_signature, test_page_not_found, test_directory_browsing, test_https_redirect
 para habilitarlas de todos modos, establece force_sitewide_checks en truesi estableces max_crawl_pages en 1 y especificas un start_url distinto de una página de inicio, se desactivarán todas las comprobaciones en todo el sitio;
 para habilitarlas de todos modos, establece force_sitewide_checks en true
- pingback_url
 Tipo: string | null
 
 URL de notificación de una tarea completada
 campo opcional
 cuando se completa una tarea, te notificaremos mediante una solicitud GET enviada a la URL que hayas especificado
 puedes usar la cadena ‘$id’ como variable $id y ‘$tag’ como variable $tag codificada para URL. Estableceremos los valores necesarios antes de enviar la solicitud.
 ejemplo:
 http://your-server.com/pingscript?id=$id
 http://your-server.com/pingscript?id=$id&tag=$tag
 Nota: los caracteres especiales de pingback_url se codificarán para URL;
 es decir, el carácter # se codificará como %23
 
 más información en nuestro Centro de ayuda
- priority_urls
 Tipo: array string[] | null
 
 urls que se rastrearán omitiendo la cola
 campo opcional
 las URL especificadas en este array se rastrearán en primer lugar, omitiendo la cola de rastreo;
 Nota: debes especificar la URL absoluta;
 puedes especificar hasta 20 URL;
 todas las URL del array deben pertenecer al dominio target;
 los subdominios se ignorarán a menos que el parámetro allow_subdomains esté establecido en trueejemplo:
 "priority_urls": [ "https://dataforseo.com/apis/serp-api", "https://dataforseo.com/contact" ]
- respect_sitemap
 Tipo: boolean | null
 
 respetar el sitemap al rastrear
 campo opcional
 establécelo en true si quieres seguir el orden de las páginas indicadas en el sitemap principal al rastrear;
 valor predeterminado: false
 Nota: si se establece en true, el valor de click_depth en la respuesta de la API será igual a 0;
 el campo max_crawl_depth de la solicitud se ignorará; puedes especificar el número de páginas que se van a rastrear con el parámetro max_crawl_pages
- return_despite_timeout
 Tipo: boolean | null
 
 devolver datos de las páginas a pesar del error de tiempo de espera
 campo opcional
 si es true, se proporcionarán datos de las páginas que no se cargaron en 120 segundos y respondieron con un error de tiempo de espera;
 valor predeterminado: false
- robots_txt_merge_mode
 Tipo: string | null
 
 combinar o sustituir la configuración de robots.txt
 campo opcional
 valores posibles: merge, override;
 establécelo en override si quieres ignorar las restricciones de rastreo del sitio web y otra configuración de robots.txt
 valor predeterminado: merge;
 Nota: si se establece en override, especifica el parámetro custom_robots_txt
- start_url
 Tipo: string | null
 
 la primera url que se va a rastrear
 campo opcional
 Nota: debes especificar una URL absoluta
 si quieres rastrear una sola página, especifica su URL en este campo y, además, establece el parámetro max_crawl_pages en 1
 también puedes usar el endpoint Instant Pages en vivo para obtener datos específicos de la página
- store_raw_html
 Tipo: boolean | null
 
 almacenar el HTML de las páginas rastreadas
 campo opcional
 establécelo en true si quieres obtener el HTML de la página con el endpoint OnPage Raw HTML
 valor predeterminado: false
- support_cookies
 Tipo: boolean | null
 
 admitir cookies en las páginas rastreadas
 campo opcional
 establécelo en true para admitir cookies al rastrear las páginas
 valor predeterminado: false
- switch_pool
 Tipo: boolean | null
 
 cambiar el grupo de proxies
 campo opcional
 si es true, se usarán grupos de proxies adicionales para obtener los datos solicitados;
 el parámetro puede usarse si se establecen muchas tareas simultáneamente, lo que provoca errores rate-limit o site_unreachable ocasionales
- tag
 Tipo: 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 de tag especificado en el objeto data de la respuesta
- target
 Tipo: string
 
 dominio de destino
 campo obligatorio
 el nombre de dominio debe especificarse sin https:// y www.
 si especificas la URL de la página, los resultados se devolverán para el dominio incluido en la URL
- validate_micromarkup
 Tipo: boolean | null
 
 habilitar la validación de microdatos
 campo opcional
 establécelo en true si quieres usar el endpoint OnPage API Microdata
 valor predeterminado: false

Respuestas

200
Tipo: object | null · Response36Afe1097B20_OnPageTaskPostResponseInfo
cost
Tipo: number | null Formato: double

costo total de las tareas, USD

status_code
Tipo: integer | null

código de estado general puedes encontrar la lista completa de los códigos de respuesta aquí

status_message
Tipo: string | null

mensaje informativo general puedes encontrar la lista completa de los mensajes informativos generales aquí

tasks
Tipo: array (object | null)[] | null

array de tareas

Tipo: object | null · Response36Afe1097B20_OnPageTaskPostTaskInfo
cost
Tipo: number | null Formato: double

costo total de las tareas, USD

data
Tipo: object | null

contiene los mismos parámetros que especificaste en la solicitud POST

propertyName
Tipo: object | null
id
Tipo: string | null

identificador de la tarea identificador único de la tarea en nuestro sistema en formato UUID

path
Tipo: array (string | null)[] | null

ruta de la URL

result
Tipo: object | null

array de resultados
en este caso, el valor será null

result_count
Tipo: integer | null Formato: int64

número de elementos en el array de resultados

status_code
Tipo: integer | null

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í

status_message
Tipo: string | null

mensaje informativo de la tarea puedes encontrar la lista completa de los mensajes informativos generales aquí

time
Tipo: string | null

tiempo de ejecución, segundos

tasks_count
Tipo: integer | null Formato: int64

el número de tareas en el array de tareas

tasks_error
Tipo: integer | null Formato: int64

el número de tareas en el array de tareas devueltas con un error

time
Tipo: string | null

tiempo total de ejecución, en segundos

version
Tipo: string | null

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

post/v1/beta/dataforseo/on_page/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "max_crawl_pages": 10,
    "load_resources": true,
    "enable_javascript": true,
    "custom_js": "meta = {}; meta.url = document.URL; meta;",
    "tag": "some_string_123",
    "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
  }
]'

Mostrar esquema

{
  "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": null
    }
  ]
}

Operación correcta

Configurar tareas de OnPage

AutenticaciónRequired

DataForSEO

Configurar tareas de OnPage

Referencia de precios