Beta privada. Lookup ya se puede llamar hoy con tu clave de API habitual, en cualquier plan incluido Founding, y descuenta de tu cuota mensual de ops igual que cualquier otra llamada. No está anunciado ni disponible de forma general: las formas de la solicitud y de la respuesta pueden cambiar sin avisar, y no hay ningún compromiso de estabilidad ni de soporte, así que todavía no montes nada crítico encima. La hoja de ruta está en
Próximamente, y cada versión se anuncia en
el changelog.
`POST /v2/lookup` es una API de búsqueda web construida para agentes LLM:
ejecuta una búsqueda en una de seis categorías y devuelve una lista de
resultados plana y neutral respecto al proveedor. Define `perceive_top` y
también renderiza las URLs de los N primeros resultados en un navegador
real, de modo que un agente obtiene la página de resultados del motor de
búsqueda (SERP) *y* el contenido de la página detrás de cada resultado en
un único viaje de ida y vuelta. Como alternativa a una API SERP, colapsa
la pila habitual (llamar a una API de búsqueda, analizar sus resultados
y luego lanzar un scraper) en una sola llamada. Será la respuesta de
EnConvert a `/search` de Firecrawl.
Serper es el proveedor de búsqueda que está detrás. La solicitud y la
respuesta hablan un vocabulario de búsqueda neutral (`category`,
`country`, `locale`, `time_filter`), de modo que un futuro cambio de
proveedor no altera el contrato contra el que programas.
Esta es la llamada útil más pequeña. Envía una consulta y obtén de vuelta
los mejores resultados web:
```bash
curl -X POST https://api.enconvert.com/v2/lookup \
-H "X-API-Key: sk_your_private_key" \
-H "Content-Type: application/json" \
-d '{
"query": "headless chrome pdf rendering"
}'
```
La respuesta es una lista de resultados plana más procedencia para la
correlación con soporte:
```json
{
"lookup_id": 81423,
"query": "headless chrome pdf rendering",
"category": "web",
"total": 10,
"results": [
{
"title": "Generate PDFs with headless Chrome",
"url": "https://example.com/guide/chrome-pdf",
"snippet": "Render a page and print it to PDF...",
"position": 1
},
{
"title": "Print to PDF with the Chrome DevTools Protocol",
"url": "https://example.dev/cdp/print-to-pdf",
"snippet": "Page.printToPDF returns base64 PDF data...",
"position": 2
}
],
"perceive_top": 0,
"perceive_operation_ids": [],
"credits": 1,
"cost_cents": 0.06,
"warnings": []
}
```
---
## Endpoints
| Método | Ruta | Propósito |
|--------|------|---------|
| `POST` | `/v2/lookup` | Ejecuta una búsqueda y, opcionalmente, auto-percibe las URLs de los N primeros resultados. |
`/v2/lookup` es un endpoint de llamada única, sin una ruta separada
de estado o de recuperación. Cuando auto-percibes, cada página renderizada
se convierte en una operación de [percepción](/es/docs/endpoints/perceive.md) de
primer nivel con su propio `operation_id`, que puedes volver a obtener más
tarde mediante `GET /v2/perceive/{operation_id}`.
**Content-Type:** `application/json`.
---
## Autenticación
Autentícate con una clave privada en el encabezado `X-API-Key` para
llamadas de servidor a servidor. Este es el camino que usan los ejemplos
siguientes.
```http
X-API-Key: sk_your_private_key
```
Las claves públicas con un token bearer JWT también funcionan, usando el
mismo flujo que cualquier otro endpoint: genera un token con tu clave
`pk_` y luego envíalo como `Authorization: Bearer