# Scraper LLM de ChatGPT en vivo

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/ai_optimization/chat_gpt/llm_scraper/live/advanced`

**Tags:** DataForSEO

Pregunta a ChatGPT por un `keyword` como lo haría un usuario y devuelve la respuesta analizada. Devuelve `keyword`, `location_code`, `language_code`, `model`, `datetime`, `markdown`, `sources`, `fan_out_queries` y `brand_entities`: `markdown` es la respuesta tal como la representó el asistente, `sources` las páginas citadas y `brand_entities` las marcas mencionadas. `force_web_search` hace que navegue en lugar de responder desde el entrenamiento. Envuelto en el envoltorio de DataForSEO: los datos en `tasks[0].result` y el resultado en `tasks[0].status_code`; una solicitud rechazada sigue devolviendo HTTP 200. Este es el endpoint para «qué dice ChatGPT de nosotros»; para contar menciones en muchas respuestas usa `post_dataforseo_ai_llm_mentions_aggregated_metrics_live` en lugar de hacer scraping repetidamente. La forma sin procesar es `post_dataforseo_ai_chat_gpt_llm_scraper_live_html`.

### Pricing reference

- Medición: costo de respuesta reportado.
- Estimación de referencia por solicitud: USD 0.004.
- Multiplicador de referencia del cliente: 1.0. No lo apliques de nuevo a un importe ya liquidado del cliente.

Solo metadatos de referencia; no son 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>)
- [lenguaje de marcado markdown](<https://en.wikipedia.org/wiki/Markdown>)

## 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": {
          "keyword": {
            "type": "string",
            "description": "<em>palabra clave</em><br><strong>campo obligatorio</strong><br>puedes especificar <strong>hasta 2000 caracteres</strong> en el campo <code>keyword</code><br>todos los %## se decodificarán (el carácter ‘+’ se decodificará como un espacio)<br>si necesitas usar el carácter “%” en tu <code>keyword</code>, especifícalo como “%25”;<br>si necesitas usar el carácter “+” en tu <code>keyword</code>, especifícalo como “%2B”<p>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"
          },
          "location_name": {
            "type": "string",
            "description": "<em>nombre completo de la ubicación del motor de búsqueda</em><br><strong>campo obligatorio si no especificas</strong> <code>location_code</code><br><strong>si usas este campo, no necesitas especificar <code>location_code</code></strong><br>puedes obtener la lista de ubicaciones disponibles del motor de búsqueda y su <code>location_name</code> haciendo una solicitud independiente a <code>https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations</code><br>ejemplo:<br><code class=\"long-string\">United States</code>"
          },
          "location_code": {
            "type": "integer",
            "description": "<em>código de ubicación del motor de búsqueda</em><br><strong>campo obligatorio si no especificas</strong> <code>location_name</code><br><strong>si usas este campo, no necesitas especificar <code>location_name</code></strong><br>puedes obtener la lista de ubicaciones disponibles de los motores de búsqueda y su <code>location_code</code> haciendo una solicitud independiente a <code>https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations</code><br>ejemplo:<br><code class=\"long-string\">2840</code>"
          },
          "language_name": {
            "type": "string",
            "description": "<em>nombre completo del idioma del motor de búsqueda</em><br><strong>campo obligatorio si no especificas <code>language_code</code>;</strong><br>si usas este campo, no necesitas especificar <code>language_code</code>;<br>puedes obtener la lista de idiomas disponibles del motor de búsqueda y su <code>language_name</code> haciendo una solicitud independiente a <code>https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/languages</code>"
          },
          "language_code": {
            "type": "string",
            "description": "<em>código de idioma del motor de búsqueda</em><br><strong>campo obligatorio si no especificas <code>language_name</code>;</strong><br>si usas este campo, no necesitas especificar <code>language_name</code>;<br>puedes obtener la lista de idiomas disponibles del motor de búsqueda y su <code>language_code</code> haciendo una solicitud independiente a <code>https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/languages</code>"
          },
          "force_web_search": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>obliga al agente de IA a usar la búsqueda web</em><br>campo opcional<br>cuando está habilitado, el modelo de IA se ve obligado a acceder y citar información web actual;<br>valor predeterminado: <code>false</code>;<br><strong>Nota:</strong> aunque el parámetro se establezca en <code>true</code>, no hay garantía de que se citen fuentes web en la respuesta"
          },
          "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": [
          {
            "language_code": "en",
            "location_code": 2840,
            "keyword": "albert einstein"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "language_code": "en",
      "location_code": 2840,
      "keyword": "albert einstein"
    }
  ]
}
```

## 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_AiOptimizationChatGptLlmScraperLiveAdvancedResponseInfo"
    }
  ]
}
```

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

`#/components/schemas/Response36Afe1097B20_AiOptimizationChatGptLlmScraperLiveAdvancedResponseInfo`

```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_AiOptimizationChatGptLlmScraperLiveAdvancedTaskInfo"
              }
            ]
          },
          "description": "<em>array de tareas</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_AiOptimizationChatGptLlmScraperLiveAdvancedResultInfo

`#/components/schemas/Response36Afe1097B20_AiOptimizationChatGptLlmScraperLiveAdvancedResultInfo`

```json
{
  "type": "object",
  "properties": {
    "keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>palabra clave recibida en un array POST<br></em><strong>la palabra clave se devuelve con %## decodificado (el símbolo más '+' se decodificará como un espacio)</strong>"
    },
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>código de ubicación en un array POST</em>"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>código de idioma en un array POST</em>"
    },
    "model": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>indica la versión del modelo</em>"
    },
    "check_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>URL directa a los resultados del motor de búsqueda<br></em>puedes usarla para asegurarte de que proporcionamos resultados exactos"
    },
    "datetime": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>fecha y hora en que se recibió el resultado</em><br>en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”<br>ejemplo:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00</code>"
    },
    "markdown": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>contenido del elemento en formato markdown</em><br>contenido del resultado formateado en el lenguaje de marcado markdown"
    },
    "search_results": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_ChatgptSearchResult"
          }
        ]
      },
      "description": "<em>array de resultados de búsqueda</em><br>todas las salidas de búsqueda web que recuperó el modelo al buscar información, incluidas las duplicadas y las entradas no utilizadas"
    },
    "sources": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_SourceInfo"
          }
        ]
      },
      "description": "<em>array de fuentes</em><br>las fuentes que el modelo citó o utilizó realmente en su respuesta final"
    },
    "fan_out_queries": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>array de consultas de fan-out</em><br>contiene consultas de búsqueda relacionadas derivadas de la consulta principal para ofrecer una respuesta más completa"
    },
    "brand_entities": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_ChatGptBrandEntity"
          }
        ]
      },
      "description": "<em>array de entidades de marca</em><br>contiene información sobre las marcas mencionadas en la respuesta"
    },
    "se_results_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em> número total de resultados</em>",
      "format": "int64"
    },
    "item_types": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>tipos de resultados de búsqueda</em><br>contiene los tipos de resultados de búsqueda (<code>items</code>) encontrados en la SERP.<br>tipos de elementos posibles:<br><code>chat_gpt_text</code>, <code>chat_gpt_table</code>, <code>chat_gpt_navigation_list</code>, <code>chat_gpt_images</code>, <code>chat_gpt_local_businesses</code>, <code>chat_gpt_products</code>"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>el número de resultados devueltos en el array <strong><code>items</code></strong></em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_BaseChatGptLlmScraperElementItem"
          }
        ]
      },
      "description": "<em>elementos de los resultados de ChatGPT</em>"
    }
  }
}
```

### Response36Afe1097B20_AiOptimizationChatGptLlmScraperLiveAdvancedTaskInfo

`#/components/schemas/Response36Afe1097B20_AiOptimizationChatGptLlmScraperLiveAdvancedTaskInfo`

```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_AiOptimizationChatGptLlmScraperLiveAdvancedResultInfo"
              }
            ]
          },
          "description": "<em>array de resultados</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_BaseChatGptLlmScraperElementItem

`#/components/schemas/Response36Afe1097B20_BaseChatGptLlmScraperElementItem`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "tipo de elemento"
    },
    "rank_group": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>clasificación de grupo en el SERP</em><br>posición dentro de un grupo de elementos con valores de <code>type</code> idénticos<br>las posiciones de los elementos con valores de <code>type</code> diferentes se omiten de <code>rank_group</code>"
    },
    "rank_absolute": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>rank absoluto en la SERP</em><br>posición absoluta entre todos los elementos"
    }
  },
  "additionalProperties": false,
  "discriminator": {
    "propertyName": "type",
    "mapping": {
      "chat_gpt_text": "#/components/schemas/Response36Afe1097B20_ChatGptTextElementItem",
      "chat_gpt_table": "#/components/schemas/Response36Afe1097B20_ChatGptTableElementItem",
      "chat_gpt_navigation_list": "#/components/schemas/Response36Afe1097B20_ChatGptNavigationListElementItem",
      "chat_gpt_images": "#/components/schemas/Response36Afe1097B20_ChatGptImagesElementItem",
      "chat_gpt_products": "#/components/schemas/Response36Afe1097B20_ChatGptProductsElementItem",
      "chat_gpt_local_businesses": "#/components/schemas/Response36Afe1097B20_ChatGptLocalBusinessesElementItem",
      "chat_gpt_ad": "#/components/schemas/Response36Afe1097B20_ChatGptAdElementItem"
    }
  }
}
```

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

`#/components/schemas/Response36Afe1097B20_ChatGptBrandEntity`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "tipo de elemento"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>nombre de la marca</em>"
    },
    "category": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>categoría de la marca</em>"
    },
    "markdown": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>nombre de la marca en formato markdown</em><br>contiene el nombre de la marca formateado en el lenguaje de marcado markdown"
    },
    "urls": {
      "type": [
        "object",
        "null"
      ],
      "description": "<em> array de URL y dominios relevantes para la marca</em>"
    }
  }
}
```

### Response36Afe1097B20_ChatgptSearchResult

`#/components/schemas/Response36Afe1097B20_ChatgptSearchResult`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "tipo de elemento"
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>URL del resultado</em>"
    },
    "domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>dominio del resultado</em>"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>título del resultado</em>"
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>descripción del resultado</em>"
    },
    "breadcrumb": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>ruta de navegación</em>"
    }
  }
}
```

### Response36Afe1097B20_SourceInfo

`#/components/schemas/Response36Afe1097B20_SourceInfo`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "tipo de elemento"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>título de la fuente</em>"
    },
    "snippet": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>descripción de la fuente</em>"
    },
    "domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>dominio de la fuente en la SERP</em>"
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>URL de origen</em>"
    },
    "thumbnail": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>miniatura de la fuente</em>"
    },
    "source_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>nombre de la fuente</em>"
    },
    "publication_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>fecha y hora en que se publicó el resultado</em><br>en el formato: “año-mes-día:minutos:horas_de_diferencia_UTC:minutos_de_diferencia_UTC”<br>ejemplo:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00</code>"
    },
    "markdown": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>contenido del elemento en formato markdown</em><br>contenido del resultado formateado en el lenguaje de marcado markdown"
    }
  }
}
```
