v0.2.0-beta

OpenAPI 3.1.0

SERP de Google Local Finder 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/local_finder/live/advanced

SERP de Google Local Finder en vivo

Devuelve los resultados locales ampliados que Google muestra cuando una consulta es claramente local, 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.02.
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)[]
- depth
  Tipo: integer | null
  
  profundidad de análisis
  
  campo opcional
  
  número de resultados en la SERP
  
  valor predeterminado: 10
  
  valor máximo: 100
  
  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, respectivamente;
  
  si la profundidad especificada es mayor que el número de resultados de la respuesta, la diferencia se reembolsará automáticamente en el saldo de tu cuenta
  
  El costo puede calcularse en la página Pricing.
- 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
- keyword
  Tipo: string
  
  palabra clave
  
  campo obligatorio
  
  puedes especificar hasta 700 caracteres en el campo keyword
  
  todos los %## se decodificarán (el carácter ‘+’ 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”
  
  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
  
  código de idioma del motor de búsqueda
  
  campo obligatorio si no especificas language_name
  
  si usas este campo, no necesitas especificar language_name
  
  puedes obtener la lista de idiomas disponibles del motor de búsqueda con su language_code haciendo una solicitud independiente a https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
  
  ejemplo:en
- language_name
  Tipo: string
  
  nombre completo del idioma del motor de búsqueda
  
  campo obligatorio si no especificas language_code
  
  si usas este campo, no necesitas especificar language_code
  
  puedes obtener la lista de idiomas disponibles del motor de búsqueda con su language_name haciendo una solicitud independiente a https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
  
  ejemplo:
  
  English
- location_code
  Tipo: integer
  
  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 con su location_code haciendo una solicitud independiente a https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
  
  ejemplo:
  
  2840
- location_coordinate
  Tipo: string
  
  coordenadas GPS de una ubicación
  
  campo obligatorio si no 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,zoom"
  
  si no se especifica "zoom", se aplicará 9z como valor predeterminado
  
  el número máximo de dígitos decimales para "latitude" y "longitude": 7
  
  el valor mínimo para "zoom": 4z
  
  el valor máximo para "zoom": 18z
  
  ejemplo:
  
  52.6178549,-155.352142,20z
- location_name
  Tipo: string
  
  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/{{low_se_name}}/locations
  
  ejemplo:
  
  London,England,United Kingdom
- min_rating
  Tipo: number | null Formato: double
  
  filtrar resultados por calificación mínima
  
  campo opcional
  
  valores posibles para desktop: 3.5, 4, 4.5;
  
  valores posibles para mobile: 2, 2.5, 3, 3.5, 4, 4.5
- 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
- priority
  Tipo: integer | null
  
  prioridad de la tarea
  
  campo opcional
  
  puede tomar los siguientes valores:
  
  1 – prioridad de ejecución normal (definida de forma predeterminada)
  
  2 – prioridad de ejecución alta
  
  Se te cobrará un cargo adicional por las tareas con prioridad de ejecución alta.
  El costo puede calcularse en la página Pricing.
- 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 emparejarla con el resultado
  
  encontrarás el valor tag especificado en el objeto data de la respuesta
- time_filter
  Tipo: string | null
  
  filtrar resultados por horario de apertura
  
  campo opcional
  
  usando este campo, puedes filtrar los lugares de los resultados por el horario en que un lugar está abierto a los visitantes
  
  ten en cuenta que Google también puede proporcionar resultados que no coincidan con este filtro
  
  valores posibles: "open_now", "24_hours", "$day_value", "$day_value;$time_value";
  
  en lugar de $day_value, usa uno de estos valores: "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday";
  
  en lugar de $time_value, usa uno de estos valores: "00", "01", "02", "03", "04", "05", "06", "07", "08", "09", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23"
  
  ejemplo: "tuesday;18"

Respuestas

200
Tipo: object | null · Response36Afe1097B20_SerpGoogleLocalFinderLiveAdvancedResponseInfo
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_SerpGoogleLocalFinderLiveAdvancedTaskInfo
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 exactos

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:
local_pack

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

elementos del elemento

Tipo: object | null · Response36Afe1097B20_LocalPackSerpElementItem
Tipo: object · Response36Afe1097B20_LocalPackSerpElementItem
type
Discriminador
Tipo: string | null

tipo de elemento

booking_url
Tipo: string | null

URL de la página de reserva

cid
Tipo: string | null

ID de cliente definido por Google

description
Tipo: string | null

descripción del enlace

domain
Tipo: string | null

dominio del sitio web que aloja el vídeo

is_paid
Tipo: boolean | null

indica si el elemento es un anuncio

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

phone
Tipo: string | null

número de teléfono

position
Tipo: string | null

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

rank_absolute
Tipo: integer | null

rank absoluto en la SERP
posición absoluta entre todos los elementos de la SERP
siempre es igual a 0 para desktop

rank_group
Tipo: integer | null

clasificación de grupo en la SERP
posición dentro de un grupo de elementos con valores de type idénticos;
las posiciones de los elementos con valores de type diferentes se omiten de rank_group;
siempre es igual a 0 para desktop

rating
Tipo: object | null · Response36Afe1097B20_RatingInfo

la valoración del elemento
la tasa de popularidad basada en reseñas y mostrada en la SERP;
si no existe, equivale a null

rating_max
Tipo: integer | null

el valor máximo para un rating_type

rating_type
Tipo: string | null

el tipo de valoración aquí puedes encontrar los siguientes elementos: Max5, Percents, CustomMax

value
Tipo: number | null Formato: double

el valor de la valoración

votes_count
Tipo: integer | null Formato: int64

la cantidad de feedback

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

title
Tipo: string | null

título de la fila

url
Tipo: string | null

URL de la fuente de reseñas de terceros

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

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

total de resultados en el 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, indicaremos 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/local_finder/live/advanced

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/local_finder/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "local nail services",
    "min_rating": 4.5,
    "time_filter": "monday"
  }
]'

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,
          "items_count": null,
          "items": [
            {
              "type": "[Max Depth Exceeded]",
              "page": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "xpath": "[Max Depth Exceeded]",
              "rectangle": "[Max Depth Exceeded]",
              "rank_group": "[Max Depth Exceeded]",
              "rank_absolute": "[Max Depth Exceeded]",
              "title": "[Max Depth Exceeded]",
              "description": "[Max Depth Exceeded]",
              "domain": "[Max Depth Exceeded]",
              "phone": "[Max Depth Exceeded]",
              "booking_url": "[Max Depth Exceeded]",
              "url": "[Max Depth Exceeded]",
              "is_paid": "[Max Depth Exceeded]",
              "rating": "[Max Depth Exceeded]",
              "cid": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operación correcta

SERP de Google Local Finder en vivo

AutenticaciónRequired

DataForSEO

SERP de Google Local Finder en vivo

Referencia de precios