Thuisbezorgd.nl APIThuisbezorgd.nl ↗
Search Dutch restaurants by location, filter by cuisine, and retrieve delivery ETAs, fees, and ratings from Thuisbezorgd.nl via 4 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/638775b6-0f1b-4205-8f0e-1ce1f1971ac2/search_addresses?query=Amsterdam' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for addresses in the Netherlands using autocomplete. Returns address suggestions with place IDs that can be used with get_address_detail to retrieve coordinates.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results (1-20) |
| queryrequired | string | Address search query (e.g., 'Amsterdam', 'Damrak 1') |
{
"type": "object",
"fields": {
"query": "string echo of the search query",
"total": "integer count of returned addresses",
"addresses": "array of address suggestion objects with description, place_id, and type"
},
"sample": {
"data": {
"query": "Amsterdam",
"total": 5,
"addresses": [
{
"type": "address",
"place_id": "ChIJVXealLU_xkcRja_At0z9AGY",
"description": "Amsterdam, Nederland"
}
]
},
"status": "success"
}
}About the Thuisbezorgd.nl API
The Thuisbezorgd.nl API provides 4 endpoints for finding restaurants and resolving addresses across the Netherlands. Starting with search_addresses and get_address_detail, you can resolve any Dutch address to GPS coordinates, then pass those to search_restaurants to retrieve nearby restaurant listings with cuisines, ratings, and delivery fees, or to get_restaurant_info for live ETAs, fee bands, and availability status.
Address Resolution
The search_addresses endpoint accepts a free-text query and returns up to 20 address suggestions, each with a description, place_id, and type. Pass any of those place_id values to get_address_detail to retrieve a fully geocoded record including latitude, longitude, postcode, city, street, street_number, country_code, and a formatted_address string. These coordinates are the required inputs for both restaurant-facing endpoints.
Restaurant Search
search_restaurants takes latitude and longitude and returns a list of restaurants in the delivery area, along with total_found, the delivery_area postal code, and the active currency. Each restaurant object carries its id, name, slug, address, rating, cuisines array, and delivery metadata. An optional cuisine parameter filters results (e.g., 'Indian', 'Pizza', 'Chinese'), and service_type can be set to 'delivery' or 'collection' to narrow service availability.
Restaurant Detail
get_restaurant_info accepts a restaurant_id from search results plus delivery coordinates. It returns a rating object with average_stars and review count, a delivery_eta range in minutes (lower_bound_minutes, upper_bound_minutes), and a delivery_fees object that includes minimum_order_value_cents, currency, and a fee_bands array for tiered fee structures. The response also includes is_busy, is_temporarily_offline, service_types with per-type offline flags, and max_basket_items.
Coverage and Scope
All endpoints target the Dutch market exclusively — Thuisbezorgd.nl operates in the Netherlands only. Address lookups resolve Netherlands addresses; restaurant results are scoped to Dutch delivery zones. No menu item data or order-placement endpoints are included in the current API.
- Build a restaurant finder app that maps nearby delivery options using coordinates from get_address_detail
- Compare delivery ETAs and fee bands across multiple restaurants in a given Amsterdam postcode
- Filter restaurants by cuisine type (e.g., 'Chinese', 'Pizza') to populate category-specific dining feeds
- Monitor restaurant availability and busy status in real time using is_busy and is_temporarily_offline fields
- Aggregate ratings and review counts from search_restaurants to rank top-rated takeaway options in a neighbourhood
- Validate Dutch delivery addresses and extract structured postcode and city data via get_address_detail
- Determine minimum order thresholds and tiered delivery fees for cost-comparison tools using delivery_fees fee_bands
| 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.