Private Beta. Lookup ist heute mit deinem normalen API-Schlüssel aufrufbar, in jedem Tarif einschließlich Founding, und zieht wie jeder andere Aufruf von deinem monatlichen Ops-Kontingent ab. Angekündigt oder allgemein verfügbar ist Lookup nicht: Request- und Response-Formen können sich jederzeit ohne Vorankündigung ändern, und es gibt keine Stabilitäts- oder Supportzusage, baue also noch nichts Tragendes darauf. Die Roadmap steht unter
Demnächst, und jedes Release wird im
Changelog angekündigt.
`POST /v2/lookup` ist eine Websuche-API für LLM-Agenten: Sie führt eine
Suche in einer von sechs Kategorien aus und liefert eine flache,
anbieterneutrale Ergebnisliste zurück. Setzt du `perceive_top`, rendert sie
zusätzlich die Top-N-Ergebnis-URLs in einem echten Browser, sodass ein
Agent die Suchmaschinen-Ergebnisseite (SERP) *und* den Seiteninhalt hinter
jedem Treffer in einem einzigen Roundtrip erhält. Als SERP-API-Alternative
fasst sie den üblichen Stack (eine Such-API ansprechen, deren Ergebnisse
parsen, dann einen Scraper hinterherschicken) zu einem einzigen Aufruf
zusammen. Sie wird EnConverts Antwort auf Firecrawl `/search` sein.
Serper ist der Suchanbieter dahinter. Request und Response sprechen ein
neutrales Suchvokabular (`category`, `country`, `locale`, `time_filter`),
sodass ein künftiger Anbieterwechsel den Vertrag, gegen den du
programmierst, nicht ändert.
Hier ist der kleinste sinnvolle Aufruf. Sende eine Query, erhalte die
obersten Webergebnisse zurück:
```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"
}'
```
Die Response ist eine flache Ergebnisliste plus Provenienz für die
Support-Korrelation:
```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": []
}
```
---
## Endpunkte
| Methode | Pfad | Zweck |
|--------|------|-------|
| `POST` | `/v2/lookup` | Eine Suche ausführen und optional die Top-N-Ergebnis-URLs automatisch perceiven. |
`/v2/lookup` ist ein Single-Call-Endpunkt ohne separaten Status- oder
Abrufpfad. Beim Auto-Perceive wird jede gerenderte Seite zu
einer vollwertigen [Perceive](/de/docs/endpoints/perceive.md)-Operation mit eigener
`operation_id`, die du später über `GET /v2/perceive/{operation_id}`
erneut abrufen kannst.
**Content-Type:** `application/json`.
---
## Authentifizierung
Authentifiziere dich mit einem privaten Schlüssel im `X-API-Key`-Header
für Server-zu-Server-Aufrufe. Diesen Weg nutzen die Beispiele unten.
```http
X-API-Key: sk_your_private_key
```
Öffentliche Schlüssel mit einem JWT-Bearer-Token funktionieren ebenfalls
und nutzen denselben Ablauf wie jeder andere Endpunkt: Erzeuge ein
Token mit deinem `pk_`-Schlüssel und sende es dann als
`Authorization: Bearer