v0.2.0-beta

OpenAPI 3.1.0

Configurar tareas de Google Maps SERP

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/maps/task_post

Configurar tareas de Google Maps SERP

Encola el map pack de una consulta local, con la valoración, la dirección y el place id de cada empresa en Google, y devuelve un id de tarea en tasks[0].id. 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. La versión en vivo responde de inmediato y es más sencilla para una sola consulta; encola cuando el lote vaya a superar una llamada a una herramienta.

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: 100
  
  valor máximo: 700
  
  Tu cuenta se factura por cada SERP que contenga hasta 100 resultados;
  definir una profundidad superior a 100 puede generar cargos adicionales si el motor de búsqueda devuelve más de 100 resultados;
  
  El costo puede calcularse en la página Pricing.
- device
  Tipo: string | null
  
  tipo de dispositivo
  
  campo opcional
  
  devuelve resultados para un tipo específico de dispositivo
  
  puede tomar los valores:desktop, mobile
  
  valor predeterminado: desktop
  
  nota: para el dispositivo mobile, solo se devuelven 20 resultados por cada SERP
- 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á 17z como valor predeterminado
  
  el número máximo de dígitos decimales para "latitude" y "longitude": 7
  
  el valor mínimo para "zoom": 3z
  
  el valor máximo para "zoom": 21z
  
  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
- 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: 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
- 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;
  
  entre otros, el carácter # se codificará como %23
  
  más información en nuestro Centro de ayuda
- postback_data
  Tipo: string
  
  tipo de datos de postback_url
  
  campo obligatorio si especificas postback_url
  
  corresponde a la función que usaste para establecer la tarea
  
  valores posibles:
  
  advanced
- postback_url
  Tipo: string | null
  
  URL para enviar los resultados de la tarea
  
  campo opcional
  
  una vez completada la tarea, enviaremos una solicitud POST con sus resultados comprimidos en formato gzip a la postback_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/postbackscript?id=$id
  
  http://your-server.com/postbackscript?id=$id&tag=$tag
  
  Nota: los caracteres especiales de postback_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
  Tipo: integer | null
  
  prioridad de la tarea
  
  campo opcional
  
  puede tomar los siguientes valores:
  
  1 – prioridad de ejecución normal (establecida por defecto)
  
  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 Precios.
- 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
- search_places
  Tipo: boolean | null
  
  modo de búsqueda de lugares
  
  campo opcional
  
  el modo de búsqueda de lugares permite obtener resultados de Google Maps sobre un lugar concreto (p. ej., Apple Store en Nueva York)
  
  sin embargo, debido a las particularidades de nuestro algoritmo de minería de datos, este modo puede interferir en algunas consultas con intención local, y mostrar resultados de una ubicación distinta de la especificada en la solicitud;
  
  para evitar esta interferencia y obtener resultados correctos para palabras clave con intención local, puedes definir este parámetro en false;valor predeterminado: true
  
  Nota: si el modo search_places está desactivado y no se encontraron resultados en el área de búsqueda, el array results estará vacío
- search_this_area
  Tipo: boolean | null
  
  mostrar resultados del área mostrada
  
  campo opcional
  
  puede tomar los valores:true, false
  
  valor predeterminado: true
  
  si se define en false, el modo search_this_area se desactivará
  
  Nota: si el modo search_this_area está desactivado, las listas de Google Maps pueden contener resultados fuera del área mostrada
- 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
- 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://google.com/maps/search/pizza/@37.09024,-95.712891,4z
  
  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: allinanchor:, allintext:, allintitle:, allinurl:, cache:, define:, definition:, filetype:, id:, inanchor:, info:, intext:, intitle:, inurl:, link:, site:.

Respuestas

200
Tipo: object | null · Response36Afe1097B20_SerpGoogleMapsTaskPostResponseInfo
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_SerpGoogleMapsTaskPostTaskInfo
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/serp/google/maps/task_post

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

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 Google Maps SERP

AutenticaciónRequired

DataForSEO

Configurar tareas de Google Maps SERP

Referencia de precios