# Intención de búsqueda

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/dataforseo_labs/google/search_intent/live`

**Tags:** DataForSEO

Clasifica `keywords` como informativa, navegacional, comercial o transaccional. Devuelve `language_code`, `items_count` e `items`. 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 intención decide qué debe ser una página antes de que el volumen decida si merece la pena escribirla; combínalo con `post_dataforseo_labs_google_keyword_overview_live`.

### Referencia de precios

- Medición: Costo de respuesta reportado.
- Estimación de referencia por solicitud: USD 0.0073.
- 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.

## Related links

- [artículo del Centro de ayuda](<https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis>)

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

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "keywords": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "<em>palabras clave de destino</em><br><strong>campo obligatorio</strong><br>codificación UTF-8<br>número máximo de palabras clave que puedes especificar en este array: 1000;<br>las palabras clave se convertirán a formato minúsculo<p>obtén más información sobre las reglas y limitaciones de los campos <code>keyword</code> y <code>keywords</code> en las API de DataForSEO en este artículo del Centro de ayuda"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>identificador de tarea definido por el usuario</em><br>campo opcional<br><em>el límite de caracteres es 255</em><br>puedes usar este parámetro para identificar la tarea y relacionarla con el resultado<br>encontrarás el valor de <code>tag</code> especificado en el objeto <code>data</code> de la respuesta"
          }
        },
        "example": [
          {
            "keywords": [
              "login page",
              "audi a7",
              "elon musk",
              "milk store new york"
            ]
          }
        ]
      }
    ]
  },
  "example": [
    {
      "keywords": [
        "login page",
        "audi a7",
        "elon musk",
        "milk store new york"
      ]
    }
  ]
}
```

## Responses

### 200 — Operación 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 | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleSearchIntentLiveResponseInfo"
    }
  ]
}
```

### 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
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "la versión actual de la API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "código de estado general\npuedes encontrar la lista completa de los códigos de respuesta aquí"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "mensaje informativo general\npuedes encontrar la lista completa de los mensajes informativos generales aquí"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "tiempo total de ejecución, en segundos"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "costo total de las tareas, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "el número de tareas en el array de tareas",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "el número de tareas en el array de tareas devueltas con un error",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "identificador de la tarea\nidentificador único de la tarea en nuestro sistema en formato UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "código de estado de la tarea\ngenerado por DataForSEO; puede estar dentro del siguiente intervalo: 10000-60000\npuedes encontrar la lista completa de los códigos de respuesta aquí"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "mensaje informativo de la tarea\npuedes encontrar la lista completa de los mensajes informativos generales aquí"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "tiempo de ejecución, segundos"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "costo total de las tareas, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "número de elementos en el array de resultados",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "ruta de la URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "contiene los mismos parámetros que especificaste en la solicitud POST"
    }
  }
}
```

### Response36Afe1097B20_DataforseoLabsGoogleSearchIntentLiveItem

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleSearchIntentLiveItem`

```json
{
  "type": "object",
  "properties": {
    "keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>palabra clave objetivo en un array del POST</em>"
    },
    "keyword_intent": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_KeywordIntentInfo"
        }
      ],
      "description": "<em>datos de intención de búsqueda relevantes para la palabra clave especificada</em>"
    },
    "secondary_keyword_intents": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_KeywordIntentInfo"
          }
        ]
      },
      "description": "<em>contiene objetos con otras posibles intenciones de búsqueda para la palabra clave especificada</em>"
    }
  }
}
```

### Response36Afe1097B20_DataforseoLabsGoogleSearchIntentLiveResponseInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleSearchIntentLiveResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleSearchIntentLiveTaskInfo"
              }
            ]
          },
          "description": "<em>array de tareas</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_DataforseoLabsGoogleSearchIntentLiveResultInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleSearchIntentLiveResultInfo`

```json
{
  "type": "object",
  "properties": {
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>el número de resultados devueltos en el array <code>items</code></em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleSearchIntentLiveItem"
          }
        ]
      },
      "description": "<em>array de elementos con datos relevantes de estimación de tráfico</em>"
    }
  }
}
```

### Response36Afe1097B20_DataforseoLabsGoogleSearchIntentLiveTaskInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleSearchIntentLiveTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleSearchIntentLiveResultInfo"
              }
            ]
          },
          "description": "<em>array de resultados</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_KeywordIntentInfo

`#/components/schemas/Response36Afe1097B20_KeywordIntentInfo`

```json
{
  "type": "object",
  "properties": {
    "label": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>nombre de la intención de búsqueda</em><br>valores posibles: <code>informational</code>, <code>navigational</code>, <code>commercial</code>, <code>transactional</code>"
    },
    "probability": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>probabilidad de la intención de búsqueda</em><br><code>1</code> indica la probabilidad más alta"
    }
  }
}
```
