Shopping · Otto
Otto Such-API
Die Otto Such-API liefert Ihnen Live-Daten von Otto in dem Moment, in dem Sie fragen, als saubere, strukturierte Daten – bereit für Ihre eigene App, eine Tabelle oder einen KI-Assistenten. Kein Scraping, nichts zu warten.
100 kostenlose Anfragen pro Monat · keine Kreditkarte · ein API-Schlüssel für alle Plattformen
Das Wichtigste in Kürze
Aktualisiert am
Eine Keyword-Suche auf otto.de nach „Highboard“ liefert mehrere tausend Produkte, verteilt auf mehr als zweihundert Seiten, gemischt mit gesponserten Platzierungen und mit unterschiedlichem Ranking, je nachdem, ob Kunden nach Topsellern, Preis oder Neuheit sortieren. Die Otto Such-API von everydata.io liefert Ihnen diese Ergebnisseiten als strukturiertes JSON – ein Aufruf pro Seite, in der Sortierung Ihrer Wahl. So können Sie Rankings verfolgen, neue Angebote entdecken oder Preisstatistiken auf Kategorieebene erstellen, ohne den Shop zu rendern.
- Plattform
- Otto
- Haupt-Endpoint
- /otto-search-by-keyword
- Kontingent pro Aufruf
- 2 Anfragen
- Kostenloser Tarif
- 100 Anfr. / Monatdanach ab 30 € / Monat
Was die Otto Such-API liefert
Jede Antwort beginnt mit den Metadaten der Suche: keyword und sortStrategy geben Ihre Anfrage zurück, resultCount ist die Gesamtzahl der Treffer laut otto.de, numberOfProducts die Anzahl der Artikel auf dieser Seite, und nextPage / lastPage steuern Ihre Paginierungsschleife. Eine Suche nach Highboards liefert zum Beispiel 120 Produkte auf Seite eins von insgesamt 5.166 auf 56 Seiten.
searchProductDetails ist die Ergebnisliste. Jeder Eintrag enthält productDescription (den Angebotstitel), manufacturer, productId und die variationId, die Otto für die Kachel gewählt hat, price und retailPrice in EUR, productRating und countReview, imgUrl, dpUrl (den relativen Produktpfad inklusive ?variationId=), eine deliveryMessage wie „lieferbar - in 2-3 Werktagen bei dir“, einen Boolean sponsored und ein variations-Array mit den variationIds der Schwestervarianten und ihren Bezeichnungen, zum Beispiel „Weiß | Korpus: Weiß“.
- keyword, sortStrategy, resultCount, numberOfProducts, nextPage und lastPage für eine deterministische Paginierung
- Pro Produkt: productDescription, manufacturer, productId, variationId, dpUrl und imgUrl
- price und retailPrice als Zahlen – Rabatte auf der Ergebnisseite sind eine Subtraktion entfernt
- productRating und countReview, um nach gut bewerteten Artikeln zu filtern
- deliveryMessage und sponsored, um organische Ergebnisse von bezahlten Platzierungen zu trennen
- variations[] mit variationId und Wert für jede Farbe oder Größe, die Otto auf der Kachel zeigt
- sortBy: topseller (Standard), preis-aufsteigend, preis-absteigend, neuheiten, bewertung
Was Teams mit der Otto Such-API bauen
Keyword-Rank-Tracking
Erfassen Sie jeden Morgen mit sortBy=topseller die Position Ihrer productId für Ihre wichtigsten Begriffe, unterscheiden Sie gesponserte von organischen Plätzen und lassen Sie sich benachrichtigen, wenn ein Wettbewerber an Ihnen vorbeizieht.
Neue Angebote entdecken
Fragen Sie einen Kategoriebegriff mit sortBy=neuheiten ab und vergleichen Sie die productIds mit dem Stand von gestern, um neue Artikel, neue Marken oder neue Farbvarianten innerhalb weniger Stunden zu erkennen.
Analyse von Preisbändern
Durchlaufen Sie eine Suche mit preis-aufsteigend und preis-absteigend, um die günstigsten und teuersten Angebote einer Produktart zu finden, und berechnen Sie dann aus price und retailPrice Medianpreis und Rabatttiefe.
Audits gesponserter Platzierungen
Agenturen zählen gesponserte Kacheln pro Seite und Keyword, um zu messen, wie viel bezahltes Inventar Otto für einen Begriff verkauft und welche Marken es kaufen.
Ausgangspunkt für Produkt-Crawls
Nutzen Sie die Suche als Einstieg, um die dpUrls einer ganzen Kategorie zu sammeln, und übergeben Sie sie dann an den Produkt-Endpoint für Spezifikationen, Bilder und die vollständige Variantenmatrix.
Otto Such-API: Beispielanfrage und -antwort
Rufen Sie GET /ott/otto-search-by-keyword mit keyword und page auf; beide sind Pflicht. Mit sortBy bilden Sie die Sortierung eines Kunden nach – die Werte sind Ottos eigene deutsche Sortierschlüssel. Seite eins in der Standardsortierung topseller entspricht dem, was Besucher sehen, nachdem sie den Begriff in die Suchleiste von otto.de eingegeben haben.
GET /ott/otto-search-by-keyword
curl "https://api.everydata.io/ott/otto-search-by-keyword?keyword=highboard&page=1&sortBy=topseller" \
-H "x-api-key: YOUR_API_KEY"Antwort (gekürzt)
{
"responseStatus": "PRODUCT_FOUND_RESPONSE",
"responseMessage": "Product successfully found!",
"sortStrategy": "topseller",
"domainCode": "de",
"keyword": "highboard",
"numberOfProducts": 120,
"resultCount": 5166,
"nextPage": 2,
"lastPage": 56,
"searchProductDetails": [
{
"productDescription": "LeGer Home by Lena Gercke Highboard Essentials, Sideboard, Kommode, Anrichte, Schrank, Stauraumschrank, Breite: 111 cm, UV lackiert, Push-to-open-Funktion",
"manufacturer": "LeGer Home by Lena Gercke",
"productId": "1658198337",
"variationId": "2081559634",
"countReview": 1,
"imgUrl": "https://i.otto.de/i/otto/5ce00b97-95ba-5927-9915-35aaa2278456?$responsive_ft2$",
"price": 869.99,
"retailPrice": 1109.99,
"productRating": "1.0",
"dpUrl": "/p/leger-home-by-lena-gercke-highboard-essentials-sideboard-kommode-anrichte-schrank-stauraumschrank-breite-111-cm-uv-lackiert-push-to-open-funktion-1658198337/?variationId=2081559634",
"deliveryMessage": "lieferbar - in 2-3 Werktagen bei dir",
"sponsored": true,
"variations": [
{
"variationId": "2081559598",
"value": "Weiß | Korpus: Weiß"
},
{
"variationId": "2081559615",
"value": "Kaschmir | Korpus: Kaschmir"
}
]
}
]
}
dpUrl ist relativ – stellen Sie https://www.otto.de voran, um eine URL zu erhalten, die Sie direkt an GET /ott/otto-lookup-product übergeben können. Die variationId im Query-String ist der Artikel, den Otto auf der Kachel gezeigt hat; tauschen Sie sie gegen eine der IDs aus variations[], um eine andere Farbe zu öffnen. Tiefe Paginierung funktioniert, doch ein resultCount von mehreren tausend erfordert selten alle Seiten: Für Ranking-Analysen decken die ersten drei Seiten ab, was Kunden tatsächlich durchscrollen.
Ergebniskacheln enthalten weder shippingPrice noch eine Bestandsmenge; diese Angaben stehen auf der Produktseite. Verstehen Sie den Such-Endpoint als Ebene zum Entdecken und den Produkt-Endpoint als Detailebene, und cachen Sie Suchseiten mit withCache, wenn Sie denselben Begriff mehrmals täglich crawlen.
sortStrategy in der Antwort bestätigt, welche Sortierung otto.de tatsächlich angewendet hat. Übergeben Sie einen unbekannten sortBy-Wert, fällt Otto auf die Standardsortierung zurück, und das Feld zeigt Ihnen das an.
Verwandte Endpoints
Produkte suchen. Keyword-Suche mit Paginierung: Titel, Preis, Bewertung und Bild pro Produkt.
Produktdetails. Produktseite per URL. Vorübergehend nicht verfügbar (Bot-Schutz von otto.de), liefert 502 und wird nicht berechnet.
Bewertungen. Paginierte Bewertungen zu einem Produkt.
Preise der Otto Such-API: Bezahlen pro Anfrage
Jede Suchseite ist eine Anfrage, unabhängig von ihrer Größe – Otto zeigt je nach Begriff 24 bis 120 Produkte pro Seite. Wer 50 Keywords täglich über die ersten drei Seiten verfolgt, braucht rund 4.500 Anfragen im Monat – das passt in den Starter-Tarif (30 €). Mit withCache teilen sich wiederholte Abfragen desselben Begriffs einen Abruf der Zielseite.
- Free
- 100 Anfr. / Monat
- Starter
- 5.000 Anfr. · 30 €
- Production
- 50.000 Anfr. · 80 €
- Business
- 300.000 Anfr. · 300 €
Schritt für Schritt umsetzen
Otto Such-API: häufige Fragen
Welche Werte für sortBy werden unterstützt?
topseller (Standard), preis-aufsteigend, preis-absteigend, neuheiten und bewertung – dieselben Schlüssel, die otto.de in seinem Sortiermenü verwendet. Die angewendete Sortierung wird in sortStrategy zurückgegeben.
Wie viele Ergebnisse enthält eine Seite?
Das verrät numberOfProducts in jeder Antwort; otto.de rendert je nach Kategorie und Geräte-Layout meist zwischen 24 und 120 Kacheln. Iterieren Sie über nextPage und lastPage, statt von einer festen Seitengröße auszugehen.
Kann ich nach Marke, Farbe oder Preisspanne filtern?
Der Endpoint akzeptiert nur keyword, page und sortBy. Nehmen Sie die Marke ins Keyword auf („Vladon Highboard“), um markenbezogen zu suchen, und filtern Sie Preis oder Hersteller clientseitig anhand der gelieferten Felder.
Sind gesponserte Produkte enthalten?
Ja, sie erscheinen in der Liste genau dort, wo otto.de sie zeigt, und tragen sponsored: true. Filtern Sie sie heraus, wenn Sie das organische Ranking möchten.
Liefert die Suche Bestand oder Versandkosten?
Sie liefert pro Kachel eine deliveryMessage, die Verfügbarkeit und Lieferzeit angibt, aber weder shippingPrice noch Mengen. Rufen Sie dafür den Produkt-Endpoint mit der dpUrl auf.
Verwandte Anwendungsfälle
Starten Sie Ihre erste Suche auf otto.de
Legen Sie ein kostenloses Konto an und rufen Sie in unter einer Minute eine Suchergebnisseite als JSON ab – ohne Browser-Automatisierung, ohne Proxys.