Configurar tareas de SERP de Google Events
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Configurar tareas de SERP de Google Events
Encola los eventos que Google muestra para una consulta 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.
- Tipo: array object[]
- keywordTipo: stringobligatorio
Palabra clave que se va a buscar
- languageTipo: string
_code Código de idioma del motor de búsqueda
- languageTipo: string
_name Nombre completo del idioma del motor de búsqueda
- locationTipo: integer
_code Código de ubicación del motor de búsqueda
- locationTipo: string
_coordinate Coordenadas GPS de una ubicación
- locationTipo: string
_name Nombre completo de la ubicación del motor de búsqueda
- pingbackTipo: string
_url URL de notificación de una tarea completada
- postbackTipo: string
_data Tipo de datos de postback
- postbackTipo: string
_url URL para enviar los resultados de la tarea
- priorityTipo: integer
Prioridad de la tarea
- Tipo: object200
Respuesta correcta
- Tipo: numbercost
Costo total de las tareas, USD
- Tipo: integerstatus
_code Código de estado general
- Tipo: stringstatus
_message Mensaje informativo general
- Tipo: array string[]tasks
Array de objetos de tarea
- Tipo: integertasks
_count El número de tareas en el array de tareas
- Tipo: integertasks
_error El número de tareas del array de tareas devueltas con un error
- Tipo: numbertasks[]
.cost Costo de la tarea, USD
- Tipo: stringtasks[]
.id Identificador de la tarea en formato UUID
- Tipo: integertasks[]
.result _count Número de elementos del array de resultados
- Tipo: integertasks[]
.status _code Código de estado de la tarea
- Tipo: stringtasks[]
.status _message Mensaje de estado de la tarea
- Tipo: stringtime
Tiempo de ejecución, segundos
- Tipo: stringversion
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/serp/google/events/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "",
"location_code": 1,
"location_name": "",
"location_coordinate": "",
"language_code": "",
"language_name": "",
"priority": 1,
"postback_url": "",
"pingback_url": "",
"postback_data": ""
}
]'
{
"version": "string",
"status_code": 1,
"status_message": "string",
"time": "string",
"cost": 1,
"tasks_count": 1,
"tasks_error": 1,
"tasks": [
"string"
],
"tasks[].id": "string",
"tasks[].status_code": 1,
"tasks[].status_message": "string",
"tasks[].cost": 1,
"tasks[].result_count": 1
}