API-Dokumentation

Ein Endpoint und ein op-Feld. Alle Endpoints teilen dieselbe Anfrageform.

Schnellstart

Erst sehen, was zurückkommt? Probieren Sie den Playground. Diese Seite müssen Sie dafür nicht vorher lesen.

Registrieren Sie sich für einen Key (der Gratisplan enthält 100 Credits), dann:

curl -X POST https://widefetch.com/v1/call \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"op":"google.search","params":{"keyword":"vector database"}}'

Authentifizierung

Authorization: Bearer sk_…. Keys werden in der Konsole ausgestellt und nur einmal vollständig angezeigt; wir speichern einen Hash.

Ein Widerruf gilt sofort. Ist ein Key geleakt, widerrufen Sie ihn und stellen einen neuen aus.

Aufruf senden

POST /v1/call

Feld	Typ	Beschreibung
op	string	Der aufzurufende Endpoint, siehe Tabelle unten
params	object	Parameter für diesen Endpoint

Begrenzt synchron: Aufrufe, die in etwa 25 Sekunden fertig sind, liefern das Ergebnis direkt. Längere liefern status: "running" und eine request_id zum Pollen. Browserbasierte Endpoints (executor: browser) dauern öfter länger; http- und api-Endpoints antworten meist in ein, zwei Sekunden.

{
  "request_id": "req_7Qn1vK…",
  "status": "done",          // done | running | failed
  "outcome": "ok",
  "credits_charged": 1,      // 0 when the call failed
  "timing": {
    "queued_ms": 400,
    "ran_ms": 8100,
    "attempts": 1            // >1 means it was retried
  },
  "result": { "items": [ … ] }
}

Polling

GET /v1/requests/{request_id}

Gleiche Antwortform wie oben. Alle 2 Sekunden pollen, bis auf 5 Sekunden ausdehnen.

Abrechnungsregeln

Fehlgeschlagene Aufrufe sind kostenlos. Captchas, Rate-Limits, Timeouts und nicht zugeordnete Antworten gehen auf uns und werden automatisch erstattet.
Leere Ergebnisse werden berechnet. "Nichts gefunden" ist eine Antwort, kein Fehler, und die Kosten sind bereits entstanden.

Berechnete Outcomes

no_resultsokverified_page

Kostenlose Outcomes

bad_paramscancelledcaptchaclaim_timeoutneeds_mappingnot_configuredrate_limitedtimeouttransient

Jedes nicht aufgeführte Outcome ist kostenlos. Standardmäßig zu berechnen würde unsere Fehler zu Ihrer Rechnung machen.

Endpoints

op	credit	Parameter	Beschreibung
brave.search	1	keyword*, limit, region, language	Websuchergebnisse: Titel, URL und Snippet. Schnell und für viele parallele Aufrufe gebaut.	Ausprobieren
github.repo	1	repo*	Ein GitHub-Repository: Stars, Forks, offene Issues, Sprache, Lizenz und Topics.	Ausprobieren
github.search	1	query*, sort, order, limit	Suche nach GitHub-Repositories, sortiert nach Stars, Forks oder letzter Aktualisierung.	Ausprobieren
google.search	1	keyword*, limit, language, region	Organische Google-Ergebnisse: Titel, URL, Quelldomain und Snippet.	Ausprobieren
google.trends	1	keyword*, region	Suchinteresse aus Google Trends: Wochenreihe der letzten zwei Jahre (0–100).	Ausprobieren
hn.comments	1	keyword*, limit, sort, since	Suche in Hacker-News-Kommentaren: Originaltext, Autor und zugehörige Story.	Ausprobieren
hn.item	1	id*, comments	Ein vollständiger Hacker-News-Thread: Beitragstext und alle Kommentare.	Ausprobieren
hn.search	1	keyword*, limit, sort, since, min_points	Hacker-News-Stories: Titel, Link, Autor, Punkte, Kommentaranzahl und Zeit.	Ausprobieren

Fehlercodes

Code	Bedeutung	Was tun
400	Ungültige Parameter oder unbekanntes op	Anfrage korrigieren. Nicht berechnet.
401	Key falsch oder widerrufen	Anderen Key verwenden
402	Keine Credits mehr	Upgrade oder auf den Monatsreset warten
403	Die Allow-List dieses Keys enthält das op nicht	Feld `error` in der Antwort prüfen
429	Rate- oder Parallelitätslimit überschritten	Warten und erneut versuchen. Nicht berechnet.
502	Problem bei uns oder beim Upstream	Erneut versuchen. Nicht berechnet.

Rate-Limits

Jeder Key erlaubt standardmäßig 60 Aufrufe pro Minute bei begrenzter Parallelität. Darüber gibt es 429, keine Warteschlange.

Sie brauchen mehr? Melden Sie sich.