Products API Übersicht

Einheitliche Produkt-API für 1688, Taobao und Weidian. Übergeben Sie channel bei Suche/Detail oder verwenden Sie URL-Parse für automatische Erkennung.

Preise sind CNY Yuan - kein currency-Parameter, keine FX-Umrechnung. Setzen Sie language im JSON-Body (Sprachen). Verwenden Sie response_format: "standard" (Standard) oder "upstream" (Antwortformat).

Endpoint-Leitfaden

Thema	Endpoint	Doku
Produktdetail & SKU-Matrix	`POST /v1/products/detail`	Produktdetail
Keyword-Suche	`POST /v1/products/search`	Produktsuche
Similar (Taobao)	`POST /v1/products/similar`	Advanced endpoints
Bild zur Wiederverwendung hochladen	`POST /v1/products/upload-image`	Bild hochladen
Suche per Bild	`POST /v1/products/search-by-image`	Bildsuche
Produkt-URL parsen	`POST /v1/products/parse`	URL parsen
Antwortschemas	—	Produkt-Antwortmodelle
1688-Kategorie-IDs	—	1688-Kategorien
Channels, Fracht, Analytics	verschiedene	Erweiterte Endpoints

Channel-Fähigkeiten

Live-Flags abfragen: GET /v1/products/channels. Zusammenfassung:

Fähigkeit	1688	Taobao	Weidian
Detail	✓	✓	✓
Keyword-Suche	✓	✓	—
Bildsuche	✓	✓	—
URL-Parse	✓	✓	✓
Taobao口令 (`tao_password`)	—	✓	—
Inländische Frachtabschätzung	✓	✓	—
Automatischer Einkauf (Bestellungen)	✓	✓	Variiert

Beschaffungs-Mapping {#procurement-mapping}

Nach Variantenauswahl im Produktdetail IDs auf Bestellpositionen abbilden:

Detailfeld	Bestellfeld
`id` (1688 `offerId`; Taobao `mi_id`)	`lines[].id` (compatible: `offer_id`, Taobao `mi_id`)
`source_product_id`	1688 same as `id`; Taobao = `item_id`
`variants[].sku_id`	`lines[].spec_id`

Siehe Order Preview für den vollständigen Create-Ablauf.

Taobao-id / mi_id ändert sich regelmäßig. Nicht langfristig cachen. Veraltete Ids lassen Detail, Similar und Bestellungen fehlschlagen. Vor dem Checkout neu abrufen.

Get Support

Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days

Email support