Doku

Erste Schritte

Von der Registrierung zu den ersten Live-Daten in wenigen Minuten. Sie senden eine Webadresse oder einen Suchbegriff zusammen mit Ihrem API-Schlüssel und erhalten die Daten als JSON zurück. Danach ein kurzer Blick auf Fehler, Limits und Caching.

Drei Schritte

1
Konto anlegen
Geben Sie Ihre E-Mail-Adresse ein, bestätigen Sie sie über den Link, den wir Ihnen senden, und legen Sie ein Passwort fest. Kostenlos registrieren
2
API-Schlüssel kopieren
Beim ersten Besuch legt das Dashboard einen Schlüssel namens „default“ an und zeigt ihn einmal an. Kopieren Sie ihn und bewahren Sie ihn sicher auf.
3
Erste Anfrage stellen
Klicken Sie im Quickstart des Dashboards auf Ausprobieren oder führen Sie die Anfrage unten mit Ihrem Schlüssel aus.

Ihr API-Schlüssel

Senden Sie Ihren Schlüssel bei jeder Anfrage im Header x-api-key. Schlüssel beginnen mit ds_. Wir speichern von jedem Schlüssel nur einen Fingerabdruck, deshalb wird er nur einmal vollständig angezeigt – beim Erstellen. Bewahren Sie ihn in einem Secret Manager auf, nie in Code, der im Browser läuft. Unter API-Schlüssel können Sie weitere Schlüssel erstellen und alte widerrufen.

x-api-key: ds_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Basis-URL: https://api.everydata.io.

Ihre erste Anfrage

Suchen Sie auf Amazon nach „wireless headphones“. Das ist dieselbe Anfrage wie hinter der Schaltfläche Ausprobieren im Dashboard, in der Ihr Schlüssel direkt nach dem Erstellen schon eingetragen ist. withCache=true erlaubt eine bis zu 10 Minuten alte Antwort, was die Anfrage schnell macht.

GET /amz/amazon-search-by-keyword-asin

curl "https://api.everydata.io/amz/amazon-search-by-keyword-asin?domainCode=com&keyword=wireless+headphones&page=1&withCache=true" \
  -H "x-api-key: YOUR_API_KEY"

Was zurückkommt

Jede erfolgreiche Antwort ist JSON, das mit denselben zwei Feldern beginnt, responseStatus und responseMessage, gefolgt von den Daten des jeweiligen Endpoints. Seitenweise Ergebnisse enthalten zusätzlich currentPage, nextPage und lastPage.

200 OK

{
  "responseStatus": "PRODUCT_FOUND_RESPONSE",
  "responseMessage": "Product successfully found!",
  "domainCode": "com",
  "keyword": "wireless headphones",
  "foundProducts": [
    "…"
  ],
  "searchProductDetails": [
    "…"
  ]
}

Fehler

Fehler liefern einen kleinen JSON-Body mit dem HTTP-Status und einer lesbaren Meldung. Nur erfolgreiche Antworten und 404 (ein gültiges „nicht gefunden“) zählen gegen Ihr Kontingent.

400 Bad Request

{
  "statusCode": 400,
  "statusMessage": "Bad Request - Missing or invalid parameter: keyword: Field required"
}

HTTP	Bedeutung	Gezählt
200	Erfolg. Die Daten folgen auf responseStatus und responseMessage.	Ja
400	Ein Pflichtparameter fehlt oder hat das falsche Format.	Nein
401	Der API-Schlüssel fehlt, ist falsch oder wurde widerrufen.	Nein
403	Ihr Monatskontingent (oder das Fair-Use-Limit) ist aufgebraucht.	Nein
404	Die Seite wurde geladen, aber zu Ihrer Eingabe gibt es kein Produkt und kein Inserat.	Ja
429	Zu viele Anfragen pro Minute. Die Meldung nennt, wie viele Sekunden Sie warten müssen.	Nein
502	Die Website hat diesen Versuch blockiert. Erneut versuchen.	Nein
503	Die Website konnte nicht geladen werden. Erneut versuchen.	Nein

Limits und Kontingent

Pro Konto gelten zwei Limits: Anfragen pro Minute (10 bis 750, je nach Tarif) und Anfragen pro Monat. Beide teilen sich alle Plattformen und alle Schlüssel Ihres Kontos. Zu viele Anfragen pro Minute ergeben 429; ist das Monatskontingent aufgebraucht, erhalten Sie 403, bis es zu Beginn des nächsten Abrechnungszeitraums zurückgesetzt wird.

Anfragen, die scheitern, weil eine Website nicht geladen werden konnte (5xx), werden nicht gezählt. Ihre aktuelle Nutzung sehen Sie auf der Nutzungsseite; unter Preise stehen die Limits jedes Tarifs.

Caching

Antworten sind standardmäßig live. Wo Geschwindigkeit wichtiger ist als Aktualität, akzeptieren mehrere Endpoints withCache=true oder cacheTtl (Sekunden) und antworten dann womöglich aus einer aktuellen Kopie. Auch eine gecachte Antwort zählt als eine Anfrage.

Weiter: Stöbern Sie in der vollständigen API-Referenz.