Connect your Hood.de seller account to EcomCentral using your Hood API key from the Verkäufer-Center.
Hood.de is one of Germany's largest online marketplaces, serving millions of buyers and sellers since 2000. It operates as a fixed-price and auction platform, popular across the DACH region (Germany, Austria, Switzerland) for new and used goods in categories ranging from electronics to fashion and collectibles.
https://www.hood.de/api/v1 using your seller API key. All requests use the
X-Api-Key header for authentication.
api_key field| Key | Required | Description | Example |
|---|---|---|---|
api_key |
Required | Hood.de seller API key from Verkäufer-Center → Mein Konto → API-Zugangsdaten. Sent as X-Api-Key header on every request. |
hd_live_a1b2c3d4… |
apiKey or token — EcomCentral
checks all three automatically.
| Operation | Method | Endpoint |
|---|---|---|
| Test connection | GET | /orders/?page_size=1 |
| List orders | GET | /orders/?page=P&page_size=N |
| Order detail | GET | /orders/{id}/ |
| Add tracking | PATCH | /orders/{id}/ with { "tracking_number":"…", "carrier":"…", "status":"shipped" } |
| List products | GET | /products/?page=P&page_size=N |
| Product detail | GET | /products/{id}/ |
| Update stock | PATCH | /products/{id}/ with { "quantity": N } |
X-Api-Key: {your_key} header. List endpoints
return { count:N, results:[…] }. Single-item endpoints return the object directly
without an envelope wrapper. Pagination uses ?page={n}&page_size={n} query parameters.
Hood.de uses English status strings in its API. EcomCentral colour-codes them for at-a-glance clarity.
| Status | German equivalent | Badge colour |
|---|---|---|
| paid | Bezahlt | Green |
| shipped | Versendet | Green |
| completed / delivered / closed | Abgeschlossen / Geliefert | Green |
| pending | Ausstehend | Blue |
| new / processing | Neu / In Bearbeitung | Blue |
| awaiting_payment / awaiting_shipment | Warte auf Zahlung / Versand | Blue |
| on_hold / partially_shipped / awaiting_pickup | Wartend / Teilweise versendet | Amber |
| cancelled / refunded / returned / failed | Storniert / Erstattet / Retour | Red |
| Feature | Supported | Notes |
|---|---|---|
| View orders (paginated) | ✅ | Order ID, reference number, date, status, total + currency |
| View order detail | ✅ | Buyer info, billing & shipping addresses, line items with EAN, current tracking |
| Add tracking number | ✅ | Sets tracking_number, carrier, and status via PATCH /orders/{id}/ |
| View products (paginated) | ✅ | Product ID, EAN (as SKU), title, price, stock quantity |
| View product detail | ✅ | Full product with description (HTML stripped), category, weight, first image |
| Update stock quantity | ✅ | By product_id via PATCH /products/{id}/ with quantity |
| Test connection | ✅ | Hits GET /orders/?page_size=1 — success confirms API key is valid |
The API key is wrong or has been revoked. Return to Verkäufer-Center → Mein Konto → API-Zugangsdaten and verify or regenerate your key. Make sure there are no leading/trailing spaces in the pasted value.
Your seller account has not been granted API access. In the Verkäufer-Center, navigate to API-Zugangsdaten and click API-Zugang beantragen (Request API Access). Hood.de may require account verification before enabling API access.
The order or product ID does not exist in your Hood.de account, or the API path has changed. Verify the ID in your Hood.de Verkäufer-Center and check whether a Hood API update has altered the endpoint structure.
Hood.de may throttle requests if too many are made in a short window. EcomCentral paginates list calls (20 results per page) to stay within typical rate limits. If you hit a 429 Too Many Requests response, wait a minute before retrying. Avoid running multiple simultaneous connections to the same Hood.de account.
The Hood.de API field mapping in EcomCentral is built from MEDIUM-confidence inference
based on German marketplace REST patterns. If fields such as tracking_number,
carrier, or quantity do not update correctly, the actual Hood.de API
may use different field names. Consult the official Hood.de API documentation in your
Verkäufer-Center and contact EcomCentral support with the corrected field names.