> ## Documentation Index
> Fetch the complete documentation index at: https://glasser.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Descripción general de la API

> Conecta con una Key, busca e inspecciona Endpoints, ejecuta una solicitud y lee su resultado.

Usa datos de pago de proveedores de datos especializados en tu propia aplicación con una única Key de Glasser
y saldo. Cada **Endpoint** es una operación de un proveedor de datos, como el enriquecimiento de empresas
o la investigación de palabras clave. Busca en las fuentes de datos, inspecciona las entradas y el
Price de un Endpoint y ejecútalo para obtener los datos del proveedor de datos.

Para comprender el flujo de datos y elegir cómo se conectará tu producto, empieza por
[Integraciones](https://glasser.ai/docs/es/integrations/overview.md).

## Autenticación

La URL base de la API es `https://api.glasser.ai`. Las solicitudes a `/v1` necesitan una Key. Crea una en
[Keys](https://app.glasser.ai/keys) y configúrala como `GLASSER_API_KEY` en tu entorno.
Envíala en el encabezado `Authorization: Bearer`.

Comprueba la conexión con esta solicitud gratuita de saldo:

```bash theme={null}
curl --request GET \
  --url https://api.glasser.ai/v1/balance \
  --header "Authorization: Bearer $GLASSER_API_KEY"
```

## Límites de solicitudes

Nuestro límite actual es de **600 solicitudes por minuto por clave de API y por ruta de API**.

## Explorar proveedores de datos y Endpoints

[Lista de proveedores de datos y Endpoints](https://glasser.ai/docs/es/api-reference/endpoints/list.md) con
`GET /public/catalog`. Esta solicitud pública y gratuita no necesita una Key y devuelve la
lista completa en una sola respuesta: `providers` describe cada proveedor de datos; `entries`
enumera sus Endpoints y precios visibles.

Úsala para elegir un Endpoint durante el desarrollo o crear un selector de proveedores de datos.
La lista está en caché y no aplica la Policy de tu Key. Inspecciona el Endpoint elegido
con tu Key para consultar su esquema y Price actual.

## Buscar, inspeccionar y ejecutar

1. **[Buscar Endpoints](https://glasser.ai/docs/es/api-reference/endpoints/search.md).** Encuentra datos para tu tarea.
   Usa `query` para los términos de búsqueda, como `company enrichment`, e incluye el
   `use_case` requerido, como `Create a company profile for glasser.ai`.
   Los resultados identifican el proveedor de datos, el Endpoint y la versión del Endpoint, con su Price.
2. **[Inspeccionar el Endpoint](https://glasser.ai/docs/es/api-reference/endpoints/inspect.md).** Consulta su
   `input_schema`, un ejemplo de entrada y el Price, incluidas las reglas de cobro para cada resultado.
   Usa este esquema para crear la entrada del proveedor de datos.
3. **[Ejecutar el Endpoint](https://glasser.ai/docs/es/api-reference/runs/create.md).** Envía el `provider` y el
   `endpoint` seleccionados, junto con la entrada que creaste, a `POST /v1/runs`. Esto crea un Run
   y recupera los datos según las reglas de cobro de ese Endpoint.

La búsqueda y la inspección son gratuitas. Crear un Run requiere un encabezado
`Idempotency-Key`. Conserva el mismo valor al reintentar la misma solicitud; usa un valor nuevo para
una ejecución nueva.

## Leer el resultado

Una solicitud de datos devuelve un **Run**. Lee estos campos antes de usar el resultado:

| Campo | Qué comprobar |
| - | - |
| `status` | ¿Ha terminado el Run? Para una respuesta `202`, usa [Obtener un Run](https://glasser.ai/docs/es/api-reference/runs/get.md) para comprobarlo de nuevo. |
| `provider_response.http_status` | ¿El proveedor de datos devolvió datos o un error? `COMPLETED` puede incluir un error del proveedor de datos. |
| `provider_response.error` | El cuerpo del error del proveedor de datos cuando su respuesta no es correcta. |
| `output` | Los datos del proveedor de datos de una respuesta correcta. |
| `charge_usd` | El cobro de este Run, independientemente de su estado. |
| `run_url` | Abre el Run en tu Workspace. |

Un Run puede devolver HTTP `200` con `status: "COMPLETED"` incluso cuando el proveedor de datos
rechaza la solicitud. En ese caso, `output` es `null`; lee el estado y
el cuerpo del error del proveedor de datos en `provider_response`. Las listas de Runs solo contienen resúmenes; usa
[Obtener un Run](https://glasser.ai/docs/es/api-reference/runs/get.md) para consultar todos los detalles del error.

Reintentar un Run completado con el mismo `Idempotency-Key` y la misma entrada devuelve el
mismo resultado sin otra llamada al proveedor de datos. Usa una clave nueva para otro intento,
incluida una solicitud con una entrada modificada.

Consulta [Cómo funciona](https://glasser.ai/docs/es/how-it-works.md) para conocer los estados de Run, los precios y los reintentos.

## Soluciones para tareas comunes

Las soluciones ofrecen una ruta más corta para solicitudes comunes. Por ejemplo,
`company_intelligence` acepta un dominio, después Glasser selecciona un Endpoint y
convierte la entrada para su proveedor de datos. Úsala cuando los parámetros disponibles de Glasser
cubran tu tarea. Utiliza la misma Key y el mismo saldo, y devuelve un Run normal.

Consulta la [descripción general de Soluciones](https://glasser.ai/docs/es/api-reference/solutions/overview.md) para conocer las capacidades
disponibles, la selección de proveedores de datos y los cobros.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.