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

# Llamar a un endpoint específico

Llama a un endpoint conocido desde tu backend mediante la **HTTP API**. No se requiere ningún Agent.

**Tu backend**Endpoint fijo
→
**Glasser**HTTP API
→
**Proveedor de datos**Datos

## Llamar a un endpoint

Ejemplo: toma un nombre de usuario de Instagram de tu aplicación y recupera sus publicaciones públicas más recientes.

**1. Conecta tu backend**

**URL base:** `https://api.glasser.ai`\\

**Encabezado:** `Authorization: Bearer <your Key>`

**Cuenta de tu producto:** usa la [Key](https://app.glasser.ai/keys) de tu Workspace.\\

**Cuenta de tu usuario:** selecciona la Key de ese usuario para cada solicitud.

Guarda las Keys en tu backend. Comprueba la conexión con una solicitud gratuita a
[GET /v1/balance](https://glasser.ai/docs/es/api-reference/balance/get.md).

**2. Inspecciona el Endpoint una vez durante la configuración**

Envía JSON a [POST /v1/endpoints/inspect](https://glasser.ai/docs/es/api-reference/endpoints/inspect.md):

```json wrap theme={null}
{
  "provider": "apify",
  "endpoint": "/apify/instagram-post-scraper"
}
```

**Obtén:** el esquema de entrada y el Price actual. Este endpoint requiere `username`,
un array que contenga un nombre de usuario. La inspección es gratuita.

**3. Llámalo desde tu producto**

Envía JSON a [POST /v1/runs](https://glasser.ai/docs/es/api-reference/runs/create.md). Usa el mismo encabezado
Authorization, `Content-Type: application/json`, y un encabezado `Idempotency-Key` único para esta ejecución prevista.

```json wrap theme={null}
{
  "provider": "apify",
  "endpoint": "/apify/instagram-post-scraper",
  "input": { "username": ["mkbhd"] }
}
```

Sustituye `mkbhd` por la entrada de tu usuario.

**Obtén:** un Run con `id`, `status` y `charge_usd`. Cuando esté listo, `output`
contendrá hasta 10 publicaciones públicas con textos, cantidades de Me gusta y cantidades de comentarios.

Para `QUEUED` o `RUNNING`, [lee ese Run](https://glasser.ai/docs/es/api-reference/runs/get.md) hasta
que alcance un estado terminal. Los Runs usan el saldo del Workspace conectado.

> [accordion] Reintentos y gestión de respuestas
>
> * Establece `endpoint_version` a partir de Inspect, o no lo incluyas para usar la versión predeterminada.
>   Una versión no fija el Price; los nuevos Runs usan el Price vigente al admitirse.
> * Reintenta la misma solicitud con el **mismo `Idempotency-Key`** y la misma entrada. Sigue
>   leyendo un Run sin terminar en lugar de crear otro.
> * Comprueba `status` y `provider_response.http_status` antes de usar
>   `output`. Un Run `COMPLETED` todavía puede contener un error del proveedor de datos.
> * Guarda el ID del Run y `charge_usd` junto con el registro de solicitud de tu producto.
>   Un Run fallido todavía puede generar un cargo según el Price del endpoint.
> * Mantén separada la Key de cada usuario. Selecciónala desde su conexión autenticada,
>   no desde los campos de entrada de la solicitud.

## Explorar las API de proveedores de datos

Elige un endpoint en [Data Sources](https://glasser.ai/data-sources) y, después,
inspecciónalo para consultar su esquema. Puedes reutilizarlo sin buscarlo antes de cada Run.

Para enumerar proveedores de datos y endpoints en el código, usa
[GET /public/catalog](https://glasser.ai/docs/es/api-reference/endpoints/list.md). No se requiere ninguna Key y
la solicitud es gratuita:

```bash wrap theme={null}
curl https://api.glasser.ai/public/catalog
```

* **`providers`:** nombres y descripciones de los proveedores de datos, y cantidades de endpoints.
* **`entries`:** identificadores, descripciones, categorías y precios mostrados de los endpoints. Relaciona `provider` para encontrar los endpoints de un proveedor de datos.
* **Una respuesta:** la lista pública completa, sin paginación.

La respuesta se almacena en caché y no aplica la Policy de tu Key. Usa
[Inspect](https://glasser.ai/docs/es/api-reference/endpoints/inspect.md) con tu Key para consultar el esquema de entrada y el Price actual del endpoint seleccionado antes de ejecutarlo.

## Opcional: Solutions

La **GTM Solution** ofrece seis capacidades fijas mediante HTTP. Glasser gestiona
la selección del endpoint, la asignación de entradas y el fallback para los fallos compatibles.

* [Investigación web](https://glasser.ai/docs/es/api-reference/solutions/gtm/web_research.md) — búsquedas web, noticias y contenido de páginas.
* [Inteligencia empresarial](https://glasser.ai/docs/es/api-reference/solutions/gtm/company_intelligence.md) — información de empresas por dominio.
* [Búsqueda de personas](https://glasser.ai/docs/es/api-reference/solutions/gtm/people_search.md) — información de contacto personal y empresarial.
* [Investigación SEO](https://glasser.ai/docs/es/api-reference/solutions/gtm/seo_research.md) — palabras clave, posiciones y backlinks.
* [Investigación social](https://glasser.ai/docs/es/api-reference/solutions/gtm/social_research.md) — perfiles sociales, publicaciones y búsquedas.
* [Datos de mercado](https://glasser.ai/docs/es/api-reference/solutions/gtm/market_data.md) — datos inmobiliarios y cotizaciones bursátiles.

Cada Capability tiene su propia API en `/v1/solutions/gtm/`. Usa la misma Key y
un encabezado `Idempotency-Key`; la respuesta es un Run. Consulta
[Descripción general de Solutions](https://glasser.ai/docs/es/api-reference/solutions/overview.md) para ver un ejemplo y las
reglas de selección del proveedor de datos.


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