Partner-API
› Produktsuche › Parameter
Parameter: /search
GET
/api/partner/v1/search
| Name | Typ | Standard | Beschreibung |
|---|---|---|---|
q Pflicht |
Text 2 bis 120 Zeichen | — | Suchbegriff. Wird als Teilzeichenkette im Titel gesucht, Groß- und Kleinschreibung egal. |
brand optional |
Text | alle | Auf eine Marke einschränken, exakter Name, Schreibweise egal. |
price_min optional |
Dezimalzahl | — | Mindestpreis in Euro. |
price_max optional |
Dezimalzahl | — | Höchstpreis in Euro. |
limit optional |
ganze Zahl 1 bis 200 | 50 | Zahl der Treffer. |
offset optional |
ganze Zahl 0 bis 10.000 | 0 | Zum Blättern. |
Fehlerfälle
| Aufruf | Antwort |
|---|---|
?q=a | 400 parameter_ungueltig, mindestens 2 Zeichen. |
/search ohne q | 400 parameter_ungueltig. |
| Suchbegriff ohne Treffer | 200 mit count: 0 und leerer Liste. |
Beispiel
curl -H "X-API-Key: gw_DEIN_SCHLUESSEL" \
"https://goodsway.de/api/partner/v1/search?q=kopfh%C3%B6rer&price_max=100&limit=5"import requests
r = requests.get(
"https://goodsway.de/api/partner/v1/search",
headers={"X-API-Key": "gw_DEIN_SCHLUESSEL"},
params={"q": "kopfhoerer", "price_max": 100, "limit": 5},
timeout=30,
)
for t in r.json()["items"]:
print(t["id"], t["title"], t["price"])