Bidding Data API (1.0.0)

Download OpenAPI specification:

Provides bidding data for Heureka Group portals.

Product detail

Get Product detail Deprecated

Returns bidding and product data Deprecated since 2026-06-01, sunset 2026-11-30. Migrate to /v1/bidding/products/{productId}.",

Authorizations:

HeurekaApiKey

path Parameters

country required	string (CountryEnum) Enum: "cz" "sk" "hu" "ro" "bg"
product_id required	string (Product Id)

Responses

Response samples

200
422

Content type

application/json

{"product": {"id": 0,
"name": "string",
"url": "string",
"rating": {"rating": 0,
"rating_count": 0,
"review_count": 0
}
},
"category": {"id": 0,
"name": "string",
"slug": "string",
"min_cpc": 0
},
"manufacturer": {"id": 0,
"name": "string"
},
"offers": {"top_shop": {"id": 0,
"slug": "string"
},
"bidded": [{"id": 0,
"merchant_id": "string",
"name": "string",
"price": 0,
"min_delivery_price": 0,
"availability": {"type": "IN_STOCK",
"status": "string"
},
"shop": {"id": 0,
"slug": "string",
"name": "string",
"homepage": "string",
"verified_by_customer_status": true,
"certificate": "TESTING",
"rating": 0,
"review_count": 0
},
"marketplace": "Shows the ability to buy product via Heureka",
"gifts": ["string"
]
}
],
"regular": [{"id": 0,
"merchant_id": "string",
"name": "string",
"price": 0,
"min_delivery_price": 0,
"availability": {"type": "IN_STOCK",
"status": "string"
},
"shop": {"id": 0,
"slug": "string",
"name": "string",
"homepage": "string",
"verified_by_customer_status": true,
"certificate": "TESTING",
"rating": 0,
"review_count": 0
},
"marketplace": "Shows the ability to buy product via Heureka",
"gifts": ["string"
]
}
]
},
"images": [{"big": "string"
}
],
"top_badge": 0
}

Get product detail

Returns bidding and product data

Authorizations:

HeurekaBasicAuth

path Parameters

productId

required

string (Productid)

header Parameters

x-hg-portal

required

string (PortalEnum)

Enum: "heureka.cz" "heureka.sk"

Portal identifier (heureka.cz, heureka.sk)

Responses

Response samples

Content type

application/json

{"product": {"productId": "string",
"name": "string",
"url": "string",
"rating": {"rating": 0,
"ratingCount": 0,
"reviewCount": 0
}
},
"category": {"categoryId": "string",
"name": "string",
"slug": "string",
"minCpc": 0
},
"manufacturer": {"manufacturerId": "string",
"name": "string"
},
"offers": {"topShop": {"shopId": "string",
"slug": "string"
},
"bidded": [{"offerId": "string",
"merchantId": "string",
"name": "string",
"price": 0,
"minDeliveryPrice": 0,
"availability": {"type": "IN_STOCK",
"status": "string"
},
"shop": {"shopId": "string",
"slug": "string",
"name": "string",
"homepage": "string",
"verifiedByCustomerStatus": true,
"certificate": "TESTING",
"rating": 0,
"reviewCount": 0
},
"marketplace": true,
"gifts": ["string"
]
}
],
"regular": [{"offerId": "string",
"merchantId": "string",
"name": "string",
"price": 0,
"minDeliveryPrice": 0,
"availability": {"type": "IN_STOCK",
"status": "string"
},
"shop": {"shopId": "string",
"slug": "string",
"name": "string",
"homepage": "string",
"verifiedByCustomerStatus": true,
"certificate": "TESTING",
"rating": 0,
"reviewCount": 0
},
"marketplace": true,
"gifts": ["string"
]
}
]
},
"images": [{"big": "string"
}
],
"topBadge": 0
}