Bêta privée. Lookup est appelable dès aujourd'hui avec votre clé d'API habituelle, sur tous les forfaits y compris Founding, et décompte votre quota mensuel d'ops comme n'importe quel autre appel. Ce n'est ni annoncé ni disponible de façon générale : les formes de requête et de réponse peuvent changer sans préavis, et il n'y a aucun engagement de stabilité ni de support, donc ne construisez rien de critique dessus pour l'instant. La feuille de route est sur
Bientôt disponible, et chaque publication est annoncée dans
le changelog.
`POST /v2/lookup` est une API de recherche web conçue pour les agents LLM :
elle exécute une recherche dans l'une des six catégories et renvoie une liste
de résultats plate, neutre vis-à-vis du fournisseur. Définissez `perceive_top`
et elle effectue en plus le rendu des N premières URL de résultat dans un vrai
navigateur, de sorte qu'un agent obtient la page de résultats du moteur de
recherche (SERP) *et* le contenu de la page derrière chaque résultat en un seul
aller-retour. En tant qu'alternative à une API SERP, elle condense la pile
habituelle (interroger une API de recherche, analyser ses résultats, puis
déployer un scraper en éventail) en un seul appel. Ce sera la réponse
d'EnConvert à `/search` de Firecrawl.
Serper est le fournisseur de recherche qui l'alimente. La requête et la réponse
parlent un vocabulaire de recherche neutre (`category`, `country`, `locale`,
`time_filter`), de sorte qu'un futur changement de fournisseur ne modifie pas le
contrat sur lequel vous codez.
Voici le plus petit appel utile. Envoyez une requête, récupérez les meilleurs
résultats 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 réponse est une liste de résultats plate plus la provenance pour la corrélation
côté support :
```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": []
}
```
---
## Points de terminaison
| Méthode | Chemin | Objectif |
|--------|------|---------|
| `POST` | `/v2/lookup` | Exécuter une recherche et, en option, auto-percevoir les N premières URL de résultat. |
`/v2/lookup` est un point de terminaison à appel unique, sans chemin distinct de
statut ou de récupération. Lorsque vous auto-percevez, chaque page rendue devient
une opération [perceive](/fr/docs/endpoints/perceive.md) de premier ordre dotée de son propre
`operation_id`, que vous pouvez récupérer ultérieurement via
`GET /v2/perceive/{operation_id}`.
**Content-Type :** `application/json`.
---
## Authentification
Authentifiez-vous avec une clé privée dans l'en-tête `X-API-Key` pour les appels
serveur à serveur. C'est la voie qu'utilisent les exemples ci-dessous.
```http
X-API-Key: sk_your_private_key
```
Les clés publiques avec un jeton bearer JWT fonctionnent aussi, selon le même flux
que tout autre point de terminaison : générez un jeton avec votre clé `pk_`, puis envoyez-le
sous la forme `Authorization: Bearer