hood.de APIhood.de ↗
Access hood.de product listings, full product details, category hierarchy, autocomplete suggestions, and featured deals via a structured REST API.
curl -X GET 'https://api.parse.bot/scraper/c0b8c4ee-4db9-4f03-9a76-a79868f148a7/search_products?page=1&query=laptop&condition=new' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on hood.de with filters for condition and pagination. Returns up to 48 products per page sorted by relevance.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search keyword. |
| condition | string | Filter by condition: 'new', 'used', or 'both'. |
| category_id | integer | Category ID to filter by. 0 means all categories. |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"query": "string, the search keyword used",
"products": "array of product objects with id, title, url, price, price_value, image, seller_type, rating",
"total_on_page": "integer, number of products returned on this page"
},
"sample": {
"data": {
"page": 1,
"query": "laptop",
"products": [
{
"id": "92571966",
"url": "https://www.hood.de/i/auto-aufkleber-udo-keine-panik-s040-in-10cm-jdm-oem-sticker-wunschfarbe-92571966.htm",
"image": "https://i.hood.de/fit-in/396x396/images/44613/446137700.jpg",
"price": "8,79 €",
"title": "Auto Aufkleber Udo Keine Panik S040 in 10cm",
"rating": "5.00 Sterne - 136 Bewertungen",
"price_value": "8.79",
"seller_type": "commercial"
}
],
"total_on_page": 47
},
"status": "success"
}
}About the hood.de API
The hood.de API exposes 5 endpoints covering product search, detailed listing data, category browsing, autocomplete suggestions, and featured deals from Germany's hood.de marketplace. The search_products endpoint returns up to 48 products per page with price, seller type, and rating fields, while get_product_details provides EAN codes, brand, condition, structured properties, images, and full description text for any individual listing.
Product Search and Listing Data
The search_products endpoint accepts a query string and optional filters for condition (new, used, or both) and category_id. Results are paginated via the page parameter, returning up to 48 products per page. Each product object includes id, title, url, price, price_value, image, seller_type, and rating. To filter within a specific category, pass a category_id obtained from the get_categories endpoint; setting it to 0 searches across all categories.
Full Product Details
get_product_details takes a full hood.de product url and returns a richer data shape: id, ean (EAN/GTIN, nullable), brand (nullable), price, title, images (array of URLs), condition (e.g. Neu), properties (a key-value object of structured attributes), and a full description string. This is the endpoint to use when you need to match products by barcode or extract structured specifications.
Categories and Autocomplete
get_categories returns the complete category hierarchy with no required parameters — each top-level category object contains a name and a subcategories array of objects with name and url. get_autocomplete_suggestions takes a partial query string and returns three typed suggestion lists: searchTerms (with value, id, link, and topTermFlag), categories, and manufacturers. These are useful for building type-ahead search interfaces or discovering canonical category URLs.
Deals
get_hood_deals requires no input and returns an array of deal objects from the Hood Deals page, each containing title, url, price, discount (percentage), and image. This endpoint is suited for price-tracking applications that want to monitor discounted inventory on hood.de.
- Compare prices for new vs. used products on hood.de using the
conditionfilter insearch_products. - Build a barcode lookup tool by extracting the
eanfield fromget_product_details. - Monitor discounted listings by polling
get_hood_dealsand trackingdiscountpercentages over time. - Populate a type-ahead search box with manufacturer and category suggestions from
get_autocomplete_suggestions. - Map out hood.de's full product taxonomy by walking the
categoriesandsubcategoriestree fromget_categories. - Aggregate structured product specifications using the
propertieskey-value object returned byget_product_details. - Filter category-specific search results by combining
category_idfromget_categorieswithsearch_products.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does hood.de offer an official developer API?+
What does `search_products` return and how is pagination handled?+
id, title, url, price, price_value, image, seller_type, and rating, along with a total_on_page count and the current page number. Use the page integer parameter to step through additional results. There is no total result count field in the response, so you iterate until total_on_page drops below 48.Does `get_product_details` always return an EAN and brand?+
ean and brand are nullable fields. Not all hood.de listings include a barcode or brand attribution, so these fields will be null when the source listing does not provide them.Does the API expose seller profile pages or individual seller ratings?+
search_products includes a seller_type field and a rating per product, but there are no endpoints for full seller profiles, seller feedback history, or seller inventory listings. You can fork this API on Parse and revise it to add a seller-detail endpoint.