Private Beta. Discover 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 Discover 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/discover` ist eine Sitemap-Crawler-API, die die URLs einer
Website auf die günstige Art auflistet: ein HTTP-first-Crawl plus
Sitemap-Parsing, mit einem optionalen JavaScript-Render-Fallback für
Single-Page-Apps. Es gibt keinen Screenshot, kein PDF und kein
gespeichertes Artefakt. Sie liefert eine flache,
deduplizierte Liste von URLs sowie eine Zählung, aus welcher Quelle
jede URL stammt, synchron in einem einzigen Aufruf. Sie wird das
leichtgewichtige „Website kartieren“-Primitiv sein: eine Domain angeben, die zu
verarbeitenden Seiten zurückbekommen, dann diese Liste an
[den Perceive-Endpunkt](/de/docs/endpoints/perceive.md) oder einen Ingest-Job im
Crawl-Modus übergeben.
Hier ist der kleinste sinnvolle Aufruf. Sende eine URL, erhalte ihre Karte zurück:
```bash
curl -X POST https://api.enconvert.com/v2/discover \
-H "X-API-Key: sk_your_private_key" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com"
}'
```
Die Antwort ist eine einfache URL-Liste mit Herkunfts-Zählern. Es gibt
keine signierten URLs, keine Operation-ID und kein Polling:
```json
{
"url": "https://example.com",
"mode": "hybrid",
"total": 47,
"urls": [
"https://example.com/",
"https://example.com/pricing",
"https://example.com/docs",
"https://example.com/blog/launch"
],
"pages_crawled": 12,
"truncated": false,
"robots_respected": false,
"sources": {"sitemap": 42, "crawl": 30},
"warnings": []
}
```
---
## Endpunkte
| Methode | Pfad | Zweck |
|--------|------|---------|
| `POST` | `/v2/discover` | Ermittelt die URLs einer Website ausschließlich über HTTP und liefert eine flache Liste mit Quellenzahlen zurück. |
`/v2/discover` stellt einen einzigen Pfad bereit. Er ist zustandslos:
Es gibt keine Operation-Zeile zum erneuten Abrufen und keinen Job zum
Pollen, daher gibt es auch keinen begleitenden `GET`-Endpunkt, wie ihn
[Perceive hat](/de/docs/endpoints/perceive.md).
**Content-Type:** `application/json` beim `POST`.
---
## Authentifizierung
Authentifiziere dich für Server-zu-Server-Aufrufe mit einem privaten
Schlüssel im `X-API-Key`-Header. Diesen Weg verwenden auch die
folgenden Beispiele.
```http
X-API-Key: sk_your_private_key
```
Öffentliche Schlüssel mit einem JWT-Bearer-Token funktionieren
ebenfalls, nach demselben Ablauf wie bei jedem anderen Endpunkt:
Erzeuge mit deinem `pk_`-Schlüssel ein Token und sende es dann als
`Authorization: Bearer