Beta privata. Lookup è già chiamabile oggi con la tua normale chiave API, su qualsiasi piano compreso Founding, e scala dalla tua quota mensile di ops come ogni altra chiamata. Non è annunciato né disponibile in generale: le forme di richiesta e risposta possono cambiare senza preavviso e non c'è alcun impegno di stabilità o di supporto, quindi non costruirci ancora sopra nulla di critico. La roadmap è su
In arrivo, e ogni rilascio viene annunciato nel
changelog.
`POST /v2/lookup` è un'API di ricerca web pensata per agenti LLM: esegue
una ricerca in una di sei categorie e restituisce un elenco di risultati
piatto e neutrale rispetto al provider. Imposta `perceive_top` e
l'endpoint renderizza anche gli URL dei primi N risultati in un browser
reale, così un agente ottiene la pagina dei risultati del motore di
ricerca (SERP) *e* il contenuto della pagina dietro ogni risultato in
un'unica chiamata. Come alternativa alle SERP API, comprime lo stack
abituale (interrogare un'API di ricerca, analizzarne i risultati, poi
lanciare uno scraper) in un'unica chiamata. Sarà la risposta di EnConvert
a Firecrawl `/search`.
È Serper a fornire il backend di ricerca. La richiesta e la risposta
parlano un vocabolario di ricerca neutrale (`category`, `country`,
`locale`, `time_filter`), così un futuro cambio di provider non modifica
il contratto su cui scrivi il codice.
Ecco la chiamata minima utile. Invia una query e ricevi i migliori
risultati 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 risposta è un elenco di risultati piatto più la provenienza per la
correlazione con il supporto:
```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": []
}
```
---
## Endpoint
| Metodo | Percorso | Scopo |
|--------|------|---------|
| `POST` | `/v2/lookup` | Esegue una ricerca e, opzionalmente, applica l'auto-perceive ai primi N URL dei risultati. |
`/v2/lookup` è un endpoint a chiamata singola: non esiste un percorso
separato di stato o di recupero. Quando esegui l'auto-perceive, ogni
pagina renderizzata diventa un'operazione [perceive](/it/docs/endpoints/perceive.md)
a pieno titolo con un proprio `operation_id`, che puoi recuperare in
seguito tramite `GET /v2/perceive/{operation_id}`.
**Content-Type:** `application/json`.
---
## Autenticazione
Autenticati con una chiave privata nell'header `X-API-Key` per le chiamate
server-to-server. Questo è il percorso usato negli esempi seguenti.
```http
X-API-Key: sk_your_private_key
```
Funzionano anche le chiavi pubbliche con un token bearer JWT, usando lo
stesso flusso di ogni altro endpoint: genera un token con la tua chiave
`pk_`, poi invialo come `Authorization: Bearer