v0.2.0-beta

OpenAPI 3.1.0

Google Organic SERP Advanced en vivo

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/serp/google/organic/live/advanced

Google Organic SERP Advanced en vivo

Devuelve los resultados clasificados de una palabra clave en Google, de forma síncrona. Devuelve keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count e items. advanced es la opción predeterminada; usa regular cuando solo importe la lista clasificada y html solo para comprobar qué descartó el analizador. 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.

Referencia de precios

Medición: Costo de respuesta reportado.
Estimación de referencia por solicitud: USD 0.0175.
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)[]
- browser_screen_height
  Tipo: integer | null
  
  altura de pantalla del navegador campo opcional puedes definir una altura de pantalla de navegador personalizada para calcular la clasificación en píxeles de un dispositivo concreto; se puede especificar dentro del siguiente intervalo: 240-9999; de forma predeterminada, el parámetro se establece en: 1080 para desktop; 640 para móvil en android; 812 para móvil en iOS; Nota: para usar este parámetro, establece calculate_rectangles en true
- browser_screen_resolution_ratio
  Tipo: integer | null
  
  proporción de resolución de pantalla del navegador campo opcional puedes definir una proporción de resolución de pantalla de navegador personalizada para calcular la clasificación en píxeles de un dispositivo concreto; se puede especificar dentro del siguiente intervalo: 0.5-3; de forma predeterminada, el parámetro se establece en: 1 para desktop; 3 para móvil en android; 3 para móvil en iOS; Nota: para usar este parámetro, establece calculate_rectangles en true
- 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 calcular la clasificación en píxeles de un dispositivo concreto; se puede especificar dentro del siguiente intervalo: 240-9999; de forma predeterminada, el parámetro se establece en: 1920 para desktop; 360 para móvil en android; 375 para móvil en iOS; Nota: para usar este parámetro, establece calculate_rectangles en true
- calculate_rectangles
  Tipo: boolean | null
  
  calcular la clasificación en píxeles de los elementos del SERP en resultados avanzados campo opcional la clasificación en píxeles se refiere a la distancia entre el fragmento del resultado y la esquina superior izquierda de la pantalla; Visita el Centro de ayuda para obtener más información>> de forma predeterminada, el parámetro se establece en false; Nota: se te cobrarán US$ 0,002 adicionales por usar este parámetro
- depth
  Tipo: integer | null
  
  profundidad de análisis campo opcional número de resultados en el SERP valor predeterminado: 10 valor máximo: 200 Tu cuenta se factura por cada SERP que contenga hasta 10 resultados; Definir una profundidad superior a 10 puede generar cargos adicionales si el motor de búsqueda devuelve más de 10 resultados; El costo puede calcularse en la página Precios.
- device
  Tipo: string | null
  
  tipo de dispositivo campo opcional devolver resultados para un tipo de dispositivo concreto puede tomar los valores: desktop, mobile valor predeterminado: desktop
- find_targets_in
  Tipo: array string[] | null
  
  tipos de elemento del SERP que se comprobarán para destinos campo opcional para activar este parámetro, stop_crawl_on_match también debe estar activado especifica qué tipos de elemento del SERP deben comprobarse para coincidencias de destino si no se especifica, se comprueban todos los elementos de primer nivel con los campos url y domain para destinos valores posibles: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter Nota: no puede contener los mismos tipos de elemento que ignore_targets_in ejemplo: "find_targets_in": ["organic", "featured_snippet"] más información sobre este parámetro en nuestro Centro de ayuda
- group_organic_results
  Tipo: boolean | null
  
  mostrar resultados relacionados campo opcional si se define en true, el elemento related_result de la respuesta se proporcionará como un fragmento de su resultado orgánico principal; si se define en false, el elemento related_result se proporcionará como un resultado orgánico independiente; valor predeterminado: true
- ignore_targets_in
  Tipo: array string[] | null
  
  tipos de elemento del SERP que se excluirán de la búsqueda de destinos campo opcional para activar este parámetro, stop_crawl_on_match también debe estar activado especifica qué tipos de elemento del SERP deben excluirse al buscar coincidencias de destino valores posibles: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter Nota: no puede contener los mismos tipos de elemento que find_targets_in ejemplo: "ignore_targets_in": ["paid", "images"] más información sobre este parámetro en nuestro Centro de ayuda
- keyword
  Tipo: string
  
  palabra clave campo obligatorio puedes especificar hasta 700 caracteres en el campo keyword todos los %## se decodificarán (el carácter ‘+’ también 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”; si este campo contiene parámetros como ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘cache:’, ‘define:’, ‘definition:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘site:’, el cargo por tarea se multiplicará por 5 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
- language_code
  Tipo: string | null
  
  código de idioma del motor de búsqueda campo opcional si especificas language_name 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/serp/google/languages ejemplo: en
- language_name
  Tipo: string | null
  
  nombre completo del idioma del motor de búsqueda campo opcional si especificas language_code si usas este campo, no necesitas especificar language_code 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/serp/google/languages ejemplo: English
- load_async_ai_overview
  Tipo: boolean | null
  
  cargar descripción general de IA asíncrona campo opcional define como true para obtener elementos ai_overview en los SERP aunque se carguen de forma asíncrona; si se define en false, solo obtendrás elementos ai_overview de la caché; valor predeterminado: false Nota: se te cobrarán US$ 0,002 adicionales por usar este parámetro; si el elemento no está presente o contiene "asynchronous_ai_overview": false, todos los cargos adicionales se reembolsarán en el saldo de tu cuenta
- location_code
  Tipo: integer | null
  
  código de ubicación del motor de búsqueda campo obligatorio si no especificas location_name o location_coordinate si usas este campo, no necesitas especificar location_name o location_coordinate puedes obtener la lista de ubicaciones disponibles de los motores de búsqueda y su location_code haciendo una solicitud independiente a https://api.dataforseo.com/v3/serp/google/locations ejemplo: 2840
- location_coordinate
  Tipo: string | null
  
  coordenadas GPS de una ubicación campo opcional si especificas location_name o location_code si usas este campo, no necesitas especificar location_name o location_code el parámetro location_coordinate debe especificarse en el formato "latitude,longitude,radius" el número máximo de dígitos decimales para "latitude" y "longitude": 7 el valor mínimo para "radius": 199 (mm) el valor máximo para "radius": 199999 (mm) ejemplo: 53.476225,-2.243572,200
- location_name
  Tipo: string | null
  
  nombre completo de la ubicación del motor de búsqueda campo obligatorio si no especificas location_code o location_coordinate si usas este campo, no necesitas especificar location_code o location_coordinate 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/serp/google/locations ejemplo: London,England,United Kingdom
- match_type
  Tipo: string | null
  
  tipo de coincidencia de destino campo obligatorio si se especifica stop_crawl_on_match tipo de coincidencia para match_value valores posibles: domain – dominio o subdominio específico with_subdomains – dominio principal y subdominios wildcard – patrón comodín
- match_value
  Tipo: string | null
  
  dominio, subdominio o valor comodín de destino campo obligatorio si se especifica stop_crawl_on_match especifica un dominio, subdominio o valor comodín de destino; Nota: el dominio o subdominio debe especificarse sin protocolo de solicitud; ejemplo: "match_value": "dataforseo.com","match_value": "/blog/post-*"
- max_crawl_pages
  Tipo: integer | null
  
  límite de páginas rastreadas campo opcional número de páginas de resultados de búsqueda que se rastrearán valor máximo: 100 Nota: se te cobrará por cada página rastreada (10 resultados orgánicos por página); más información sobre los precios en nuestra página Precios; Nota n.º 2: los parámetros max_crawl_pages y depth se complementan entre sí; más información en nuestro Centro de ayuda
- os
  Tipo: string | null
  
  sistema operativo del dispositivo campo opcional si especificas desktop en el campo device, elige entre los siguientes valores: windows, macos valor predeterminado: windows si especificas mobile en el campo device, elige entre los siguientes valores: android, ios valor predeterminado: android
- people_also_ask_click_depth
  Tipo: integer | null
  
  clics en el elemento correspondiente campo opcional especifica la profundidad de clics en el elemento people_also_ask para obtener elementos people_also_ask_element adicionales; Nota: se te facturarán US$ 0,00015 adicionales por cada clic; si el elemento no está presente o realizamos menos clics de los que especificaste, todos los cargos adicionales se reembolsarán en el saldo de tu cuenta valores posibles: de 1 a 4
- remove_from_url
  Tipo: array string[] | null
  
  eliminar parámetros específicos de las URL campo opcional con este campo, puedes especificar hasta 10 parámetros para eliminar de las URL del resultado ejemplo: "remove_from_url": ["srsltid"] Nota: si se especifica el campo target, los parámetros de URL indicados se eliminarán antes de la búsqueda
- se_domain
  Tipo: string | null
  
  dominio del motor de búsqueda campo opcional elegimos el dominio del motor de búsqueda relevante automáticamente según la ubicación y el idioma que especifiques sin embargo, puedes definir un dominio de motor de búsqueda personalizado en este campo ejemplo: google.co.uk, google.com.au, google.de, etc.
- search_param
  Tipo: string | null
  
  parámetros adicionales de la consulta de búsqueda campo opcional obtén la lista de parámetros disponibles y más detalles aquí Nota: los siguientes parámetros del motor de búsqueda no se admiten y se desactivarán automáticamente si se especifican: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
- stop_crawl_on_match
  Tipo: array (object | null)[] | null
  
  array de destinos para detener el rastreo campo opcional si se especifica, la respuesta contendrá resultados de SERP hasta el match_value especificado, inclusive; puedes especificar hasta 10 valores de destino en este array ejemplo: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] más información sobre este parámetro en nuestro Centro de ayuda - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Tu cuenta se facturará por cada SERP rastreada a través de los destinos especificados
  
  match_type
  Tipo: string | null
  
  tipo de coincidencia del destino campo obligatorio si se especifica stop_crawl_on_match; tipo de coincidencia para match_value valores posibles: domain, with_subdomains, wildcard
  
  match_value
  Tipo: string | null
  
  dominio o valor comodín de destino campo obligatorio si se especifica stop_crawl_on_match; especifica un dominio o valor comodín de destino; Nota: el nombre de dominio debe especificarse sin protocolo de solicitud; ejemplo: dataforseo.com
- 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 asociarla al resultado encontrarás el valor tag especificado en el objeto data de la respuesta
- target
  Tipo: string | null
  
  dominio, subdominio o página web de destino para obtener resultados campo opcional un dominio o subdominio debe especificarse sin https:// y www. ten en cuenta que los resultados de las tareas específicas de destino solo incluirán elementos del SERP que contengan una cadena url; también puedes usar el carácter comodín (‘’) para especificar el patrón de búsqueda en el SERP y acotar los resultados; ejemplos: example.com - devuelve resultados para la página de inicio del sitio web con URL, como https://example.com, o https://www.example.com/, o https://example.com/; example.com - devuelve resultados para el dominio, incluidas todas sus páginas; example.com - devuelve resultados para todo el dominio, incluidas todas sus páginas y subdominios; example.com - devuelve resultados para la página de inicio independientemente del subdominio, como https://en.example.com; example.com/example-page - devuelve resultados para la URL exacta; example.com/example-page - devuelve resultados para todas las URL del dominio que comienzan con la cadena especificada
- target_search_mode
  Tipo: string | null
  
  modo de coincidencia de destinos campo opcional para activar este parámetro, stop_crawl_on_match también debe estar activado define cómo debe detenerse el rastreo cuando se especifican varios destinos en stop_crawl_on_match valores posibles: all, any all – el rastreo se detiene solo cuando se encuentran todos los destinos especificados any – el rastreo se detiene cuando se encuentra cualquier destino individual valor predeterminado: any más información sobre este parámetro en nuestro Centro de ayuda
- url
  Tipo: string | null
  
  URL directa de la consulta de búsqueda campo opcional puedes especificar una URL directa y la desglosaremos en los campos necesarios. Ten en cuenta que este método es el más difícil de procesar para nuestra API y también requiere que especifiques el idioma y la ubicación exactos en la URL. En la mayoría de los casos, no recomendamos usar este método. ejemplo: https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS Nota: los siguientes parámetros del motor de búsqueda no se admiten y se desactivarán automáticamente si se especifican en la URL: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.

Respuestas

200
Tipo: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResponseInfo
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_SerpGoogleOrganicLiveAdvancedTaskInfo
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: array (object | null)[] | null

array de resultados

check_url
Tipo: string | null

URL directa a los resultados del motor de búsqueda puedes usarla para asegurarte de que proporcionamos resultados precisos

datetime
Tipo: string | null

fecha y hora en que se recibió el resultado en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” ejemplo: 2019-11-15 12:57:46 +00:00

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

tipos de resultados de búsqueda en el SERP contiene los tipos de resultados de búsqueda (items) encontrados en el SERP. tipos de elementos posibles:answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, recipes, top_sights, scholarly_articles, popular_products, questions_and_answers, find_results_on, stocks_box, commercial_units, local_services, google_hotels, math_solver, currency_box,product_considerations, short_videos, refine_products, perspectives, discussions_and_forums, compare_sites, ai_overview

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

items del elemento

page
Tipo: integer | null

número de página de resultados de búsqueda
indica el número de la página de la SERP en la que se encuentra el elemento

position
Tipo: string | null

la alineación del elemento en la SERP
puede tomar los siguientes valores:
left, right

rectangle
Tipo: object | null · Response36Afe1097B20_AiModeRectangleInfo

parámetros del rectángulo
contiene coordenadas cartesianas y dimensiones en píxeles del fragmento del resultado en la SERP
equivale a null si calculate_rectangles en la solicitud POST no se establece en true

height
Tipo: number | null Formato: double

altura del elemento en píxeles

width
Tipo: number | null Formato: double

anchura del elemento en píxeles

x
Tipo: number | null Formato: double

coordenada del eje x coordenada del eje x de la esquina superior izquierda del fragmento del resultado, donde la esquina superior izquierda de la pantalla es el origen

y
Tipo: number | null Formato: double

coordenada del eje y coordenada del eje y de la esquina superior izquierda del fragmento del resultado, donde la esquina superior izquierda de la pantalla es el origen

type
Tipo: string | null

tipo de elemento

xpath
Tipo: string | null

el XPath del elemento

items_count
Tipo: integer | null Formato: int64

el número de resultados devueltos en el array items

keyword
Tipo: string | null

palabra clave recibida en un array POST la palabra clave se devuelve con %## decodificado (el carácter '+' se decodificará como un espacio)

language_code
Tipo: string | null

código de idioma en un array POST

location_code
Tipo: integer | null

código de ubicación en un array POST

pages_count
Tipo: integer | null Formato: int64

total de páginas de resultados de búsqueda recuperadas número total de SERP recuperados en el resultado

refinement_chips
Tipo: object | null · Response36Afe1097B20_RefinementChipsInfo

chips de refinamiento de búsqueda

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

items del elemento

domain
Tipo: string | null

dominio en la SERP

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

más opciones de refinamiento de búsqueda

domain
Tipo: string | null

dominio en la SERP

title
Tipo: string | null

título del elemento

type
Tipo: string | null

tipo de elemento

url
Tipo: string | null

URL de búsqueda con parámetros de refinamiento

title
Tipo: string | null

título del elemento

type
Tipo: string | null

tipo de elemento

url
Tipo: string | null

URL de búsqueda con parámetros de refinamiento

type
Tipo: string | null

tipo de elemento

xpath
Tipo: string | null

el XPath del elemento

se_domain
Tipo: string | null

dominio del motor de búsqueda en un array POST

se_results_count
Tipo: integer | null Formato: int64

número total de resultados en la SERP

spell
Tipo: object | null · Response36Afe1097B20_SpellInfo

autocorrección del motor de búsqueda si el motor de búsqueda proporcionó resultados para una palabra clave corregida, especificaremos la palabra clave corregida por el motor de búsqueda y el tipo de autocorrección

keyword
Tipo: string | null

palabra clave obtenida como resultado de la autocorrección del motor de búsqueda los resultados se proporcionarán para la palabra clave corregida

type
Tipo: string | null

tipo de autocorrección valores posibles: did_you_mean, showing_results_for, no_results_found_for, including_results_for nota: Yahoo y Yandex solo admiten el siguiente tipo de autocorrección: including_results_for

type
Tipo: string | null

tipo de elemento

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/serp/google/organic/live/advanced

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/organic/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein",
    "calculate_rectangles": true
  }
]'

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": [
        {
          "keyword": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "refinement_chips": {
            "type": null,
            "xpath": null,
            "items": [
              "[Max Depth Exceeded]"
            ]
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "pages_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "page": null,
              "position": null,
              "xpath": null,
              "rectangle": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operación correcta

Google Organic SERP Advanced en vivo

AutenticaciónRequired

DataForSEO

Google Organic SERP Advanced en vivo

Referencia de precios