Shopping · Otto
API ricerca Otto
API ricerca Otto: ricevi dati Otto live nel momento in cui li chiedi, in forma pulita e strutturata – pronti per la tua app, un foglio di calcolo o un assistente AI. Niente scraping, niente da mantenere.
100 richieste gratuite ogni mese · nessuna carta di credito · una chiave API per tutte le piattaforme
Dati chiave
Aggiornato il
Una ricerca su otto.de per "Highboard" restituisce diverse migliaia di prodotti distribuiti su oltre duecento pagine, mescolati a posizionamenti sponsorizzati e con un ranking diverso a seconda che l'utente ordini per più venduti, prezzo o novità. L'API ricerca Otto di everydata.io ti fornisce queste pagine di risultati come JSON strutturato, una chiamata per pagina con l'ordinamento che scegli, così puoi monitorare i ranking, scoprire nuovi annunci o calcolare statistiche di prezzo per categoria senza renderizzare lo shop.
- Piattaforma
- Otto
- Endpoint principale
- /otto-search-by-keyword
- Quota per chiamata
- 2 richieste
- Piano gratuito
- 100 rich. / mesepoi da 30 € / mese
Cosa restituisce API ricerca Otto
Ogni risposta inizia con i metadati della ricerca: keyword e sortStrategy riprendono la tua richiesta, resultCount è il numero totale di risultati riportato da otto.de, numberOfProducts indica quanti articoli ci sono in questa pagina e nextPage / lastPage guidano il tuo ciclo di paginazione. Una ricerca per Highboard, per esempio, restituisce 120 prodotti nella prima pagina su un totale di 5.166 distribuiti in 56 pagine.
searchProductDetails è l'elenco dei risultati. Ogni voce contiene productDescription (il titolo dell'annuncio), manufacturer, productId e il variationId scelto da Otto per il riquadro, price e retailPrice in EUR, productRating e countReview, imgUrl, dpUrl (il percorso relativo del prodotto con ?variationId=), deliveryMessage come "lieferbar - in 2-3 Werktagen bei dir", un booleano sponsored e un array variations con i variationId delle varianti collegate e le relative etichette, per esempio "Weiß | Korpus: Weiß".
- keyword, sortStrategy, resultCount, numberOfProducts, nextPage e lastPage per una paginazione deterministica
- Per prodotto: productDescription, manufacturer, productId, variationId, dpUrl e imgUrl
- price e retailPrice come numeri, così gli sconti nella pagina dei risultati sono a una sottrazione di distanza
- productRating e countReview per filtrare gli articoli con buone recensioni
- deliveryMessage e sponsored per separare i risultati organici dai posizionamenti a pagamento
- variations[] con variationId e valore per ogni colore o taglia che Otto mostra nel riquadro
- sortBy: topseller (predefinito), preis-aufsteigend, preis-absteigend, neuheiten, bewertung
Cosa costruiscono i team con API ricerca Otto
Monitoraggio del ranking per parola chiave
Registra ogni mattina la posizione del tuo productId per i termini principali con sortBy=topseller, distingui le posizioni sponsorizzate da quelle organiche e ricevi un avviso quando un concorrente ti supera.
Scoperta di nuovi annunci
Interroga un termine di categoria con sortBy=neuheiten e confronta i productId con l'insieme del giorno prima per individuare in poche ore nuovi articoli, nuovi brand o nuove varianti di colore.
Analisi delle fasce di prezzo
Scorri una ricerca con preis-aufsteigend e preis-absteigend per trovare le offerte più economiche e più costose di un tipo di prodotto, poi calcola prezzo mediano e profondità degli sconti da price e retailPrice.
Audit dei posizionamenti sponsorizzati
Le agenzie contano i riquadri sponsorizzati per pagina e parola chiave per misurare quanto inventario a pagamento Otto vende per un termine e quali brand lo acquistano.
Punto di partenza per il crawling dei prodotti
Usa la ricerca come punto di ingresso per raccogliere i dpUrl di un'intera categoria, poi passali all'endpoint prodotto per specifiche, immagini e matrice completa delle varianti.
API ricerca Otto: richiesta e risposta di esempio
Chiama GET /ott/otto-search-by-keyword con keyword e page, entrambi obbligatori. Aggiungi sortBy per riprodurre l'ordinamento scelto da un utente: i valori sono le chiavi di ordinamento in tedesco di Otto. La prima pagina con l'ordinamento predefinito topseller corrisponde a ciò che vede un visitatore dopo aver digitato il termine nella casella di ricerca di otto.de.
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"Risposta (abbreviata)
{
"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 è relativo: anteponi https://www.otto.de per ottenere un URL da passare direttamente a GET /ott/otto-lookup-product. Il variationId nella query string è l'articolo mostrato da Otto nel riquadro; sostituiscilo con uno degli id in variations[] per aprire un altro colore. La paginazione profonda funziona, ma un resultCount di diverse migliaia raramente richiede tutte le pagine: per il monitoraggio dei ranking le prime tre pagine coprono ciò che gli utenti scorrono davvero.
I riquadri dei risultati non contengono shippingPrice né quantità disponibili; queste informazioni si trovano nella pagina prodotto. Considera l'endpoint di ricerca come il livello di scoperta e l'endpoint prodotto come il livello di dettaglio, e metti in cache le pagine di ricerca con withCache quando esegui il crawling dello stesso termine più volte al giorno.
sortStrategy nella risposta conferma quale ordinamento ha applicato effettivamente otto.de. Se passi un valore di sortBy sconosciuto, Otto torna al suo ordinamento predefinito e il campo te lo segnala.
Endpoint correlati
Cerca prodotti. Ricerca per parola chiave con paginazione: titolo, prezzo, valutazione e immagine per prodotto.
Dettagli prodotto. Pagina prodotto tramite URL. Temporaneamente non disponibile (protezione anti-bot di otto.de): restituisce 502 e non viene addebitata.
Recensioni. Recensioni paginate per un prodotto.
Prezzi di API ricerca Otto: paghi a richiesta
Ogni pagina di ricerca è una richiesta, qualunque sia la sua dimensione: i riquadri Otto vanno da 24 a 120 prodotti per pagina a seconda del termine. Monitorare ogni giorno 50 parole chiave sulle prime tre pagine richiede circa 4.500 richieste al mese, che rientrano nel piano Starter (30 €). withCache permette alle ricerche ripetute dello stesso termine di condividere un unico fetch upstream.
- Free
- 100 rich. / mese
- Starter
- 5000 rich. · 30 €
- Production
- 50.000 rich. · 80 €
- Business
- 300.000 rich. · 300 €
Costruiscilo passo passo
API ricerca Otto: domande frequenti
Quali valori di sortBy sono supportati?
topseller (predefinito), preis-aufsteigend, preis-absteigend, neuheiten e bewertung: le stesse chiavi che otto.de usa nel suo menu di ordinamento. L'ordinamento applicato viene riportato in sortStrategy.
Quanti risultati contiene una pagina?
Te lo dice numberOfProducts in ogni risposta; di solito otto.de mostra tra 24 e 120 riquadri a seconda della categoria e del layout del dispositivo. Usa nextPage e lastPage per iterare invece di presumere una dimensione di pagina fissa.
Posso filtrare per marca, colore o fascia di prezzo?
L'endpoint accetta solo keyword, page e sortBy. Inserisci la marca nella keyword ("Vladon Highboard") per una ricerca limitata a un brand e filtra prezzo o manufacturer lato client dai campi restituiti.
I prodotti sponsorizzati sono inclusi?
Sì, compaiono nell'elenco esattamente dove li mostra otto.de e riportano sponsored: true. Escludili se vuoi il ranking organico.
La ricerca restituisce disponibilità o costi di spedizione?
Restituisce deliveryMessage per ogni riquadro, che indica disponibilità e tempi di consegna, ma non shippingPrice né quantità. Per questi dati chiama l'endpoint prodotto su dpUrl.
Casi d'uso correlati
Esegui la tua prima ricerca su otto.de
Crea un account gratuito e ottieni una pagina di risultati di ricerca in JSON in meno di un minuto, senza automazione del browser e senza proxy.