API

Die API führt dieselbe Suche aus wie die Website und liefert die Ergebnisse als Daten: standardmäßig als JSON, alternativ als XML, CSV, TSV, NDJSON oder reinen Text. Alles sind Lesezugriffe - hier wird nichts angelegt oder verändert.

Basis-URL https://api.publicwww.com

Mit einem einzigen Befehl

curl -H "Authorization: Bearer $KEY" \
     "https://api.publicwww.com/v1/search?query=%22angular.min.js%22&per_page=3"

{
  "query": "\"angular.min.js\"",
  "page": 1,
  "per_page": 3,
  "total": 278,
  "total_pages": 93,
  "returned": 3,
  "truncated": false,
  "took_ms": 2,
  "results": [
    { "domain": "imgbox.com", "url": "https://imgbox.com/", "rank": 4187, "ranked": true }
  ]
}

Endpunkte

Endpunkt	Methoden	Funktion
`/v1/search`	GET, POST	Führt eine Suche aus. Parameter, Formate.
`/v1/account`	GET	Tarif, Kontingent und Limits. Verbraucht nichts.
`/mcp`	POST	Der MCP-Server für KI-Assistenten und Agenten: dieselbe Suche als Tool, mit demselben Token.
`/`	GET	Die Selbstbeschreibung der API, einschließlich der Fehlercodes. Ohne Schlüssel.
`/openapi.json`	GET	Dasselbe als OpenAPI-3.1-Beschreibung zum Import in Postman, n8n, Make, Power Automate und andere Tools. Ohne Schlüssel.

Einen separaten Export-Endpunkt gibt es nicht. Massenabfragen laufen über /v1/search mit einem großen per_page, das in einem kostenpflichtigen Tarif bis zu einer Million Zeilen reicht; die Antwort wird gestreamt, während sie entsteht.

Was sie zusichert

Ergebnisse werden nie stillschweigend gekürzt. Ist das Tageskontingent im Browser aufgebraucht, fällt die Website unauffällig auf die Limits des kostenlosen Tarifs zurück und zeigt weniger an. Ein Skript bemerkt das nicht, daher gibt es hier stattdessen einen Fehler - 429 quota_exceeded, keine verkürzte Antwort, die vollständig aussieht.
Eine verkürzte Antwort ist als solche gekennzeichnet - truncated im Body und X-Truncated in den Headern, in jedem Format.
Websites ohne Rang sind eindeutig erkennbar - rank: null und ranked: false, nie ein interner Platzhalter, den ein Client für einen echten, sehr großen Rang halten könnte.
Lieber zum Warten auffordern als warten lassen. Kommen Anfragen zu schnell, kommt die Antwort sofort mit einem Retry-After zurück, statt die Verbindung offen zu halten.

Einen Schlüssel erhalten

Erstellen Sie ein Token in Ihrem Profil, oder lassen Sie eine Anwendung über OAuth 2.1 eines für Sie beziehen. Ein kostenpflichtiger Tarif ist erforderlich; siehe Preise. Bestehende Skripte, die die alten ?export=-URLs aufrufen, funktionieren unverändert weiter - siehe Die alten Export-URLs.

Weiter Authentifizierung