# Configurar tareas de SERP de Google Events

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/serp/google/events/task_post`

**Tags:** DataForSEO

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.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **yes**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "keyword": {
        "type": "string",
        "description": "Palabra clave que se va a buscar"
      },
      "location_code": {
        "type": "integer",
        "description": "Código de ubicación del motor de búsqueda"
      },
      "location_name": {
        "type": "string",
        "description": "Nombre completo de la ubicación del motor de búsqueda"
      },
      "location_coordinate": {
        "type": "string",
        "description": "Coordenadas GPS de una ubicación"
      },
      "language_code": {
        "type": "string",
        "description": "Código de idioma del motor de búsqueda"
      },
      "language_name": {
        "type": "string",
        "description": "Nombre completo del idioma del motor de búsqueda"
      },
      "priority": {
        "type": "integer",
        "description": "Prioridad de la tarea"
      },
      "postback_url": {
        "type": "string",
        "description": "URL para enviar los resultados de la tarea"
      },
      "pingback_url": {
        "type": "string",
        "description": "URL de notificación de una tarea completada"
      },
      "postback_data": {
        "type": "string",
        "description": "Tipo de datos de postback"
      }
    },
    "required": [
      "keyword"
    ]
  }
}
```

## Responses

### 200 — Respuesta correcta

Headers:
- `X-Request-Id` (string) — Identificador de la solicitud que se debe incluir al contactar con el soporte de Felo.

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "version": {
      "type": "string",
      "description": "La versión actual de la API"
    },
    "status_code": {
      "type": "integer",
      "description": "Código de estado general"
    },
    "status_message": {
      "type": "string",
      "description": "Mensaje informativo general"
    },
    "time": {
      "type": "string",
      "description": "Tiempo de ejecución, segundos"
    },
    "cost": {
      "type": "number",
      "description": "Costo total de las tareas, USD"
    },
    "tasks_count": {
      "type": "integer",
      "description": "El número de tareas en el array de tareas"
    },
    "tasks_error": {
      "type": "integer",
      "description": "El número de tareas del array de tareas devueltas con un error"
    },
    "tasks": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array de objetos de tarea"
    },
    "tasks[].id": {
      "type": "string",
      "description": "Identificador de la tarea en formato UUID"
    },
    "tasks[].status_code": {
      "type": "integer",
      "description": "Código de estado de la tarea"
    },
    "tasks[].status_message": {
      "type": "string",
      "description": "Mensaje de estado de la tarea"
    },
    "tasks[].cost": {
      "type": "number",
      "description": "Costo de la tarea, USD"
    },
    "tasks[].result_count": {
      "type": "integer",
      "description": "Número de elementos del array de resultados"
    }
  }
}
```

### 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**

Schema:

```json
{}
```
