pyszne.pl APIwww.pyszne.pl ↗
Search restaurants, list nearby options, and get delivery details from Pyszne.pl via 3 structured endpoints. Ratings, ETAs, fees, and cuisine types included.
curl -X GET 'https://api.parse.bot/scraper/5a6f3663-ff6c-4dda-b212-7d1d58017225/search_restaurants?limit=5&query=pizza&address=Marsza%C5%82kowska+1+Warsaw+Poland' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for restaurants and dishes by name near a given address. Returns matching restaurants and dishes with details like cuisine type, SEO name, and partner ID.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results to return |
| query | string | Restaurant or dish name to search for |
| address | string | Delivery address to search near |
{
"type": "object",
"fields": {
"query": "string, the search query used",
"total": "integer, number of results returned",
"address": "string, the delivery address used for the search",
"results": "array of matching restaurants and dishes with name, classification, partner_id, subtitle, seo_name, and image_url",
"latitude": "number, latitude of the resolved address",
"longitude": "number, longitude of the resolved address"
},
"sample": {
"data": {
"query": "pizza",
"total": 2,
"address": "Gdanska 100 Lodz Poland",
"results": [
{
"name": "Pizza",
"seo_name": "",
"subtitle": "",
"image_url": "",
"partner_id": "",
"classification": "Cuisine"
},
{
"name": "nienażarty pizza pasta",
"seo_name": "nienazarty-pizza-pasta-lodz",
"subtitle": "Italian, Pizza",
"image_url": "https://res.cloudinary.com/tkwy-prod-eu/image/upload/c_pad,h_100,w_100/f_auto/q_auto/v1/static-takeaway-com/images/restaurants/pl/O3RN0075/logo_465x320.png",
"partner_id": "19000978",
"classification": "Restaurant"
}
],
"latitude": 51.7636908,
"longitude": 19.4505395
},
"status": "success"
}
}About the pyszne.pl API
The Pyszne.pl API provides 3 endpoints to search and retrieve restaurant data from Poland's major food delivery platform. Use search_restaurants to find restaurants or dishes by name near an address, list_restaurants to pull a ranked feed of nearby venues with ratings and delivery ETAs, or get_restaurant_details to fetch fees, minimum order values, and open/busy status for a specific restaurant at a given delivery address.
Endpoints Overview
The API covers three operations against Pyszne.pl's restaurant catalog. search_restaurants accepts a free-text query (restaurant or dish name), an address, and an optional limit. It returns an array of matching results, each with name, classification, partner_id, seo_name, subtitle, and image_url, plus the geocoded latitude and longitude of the resolved address. list_restaurants takes an address and optional limit and returns all available restaurants in that area sorted by the platform's default ranking, with fields including cuisines, rating, rating_count, delivery_eta_min, delivery_eta_max, and is_open.
Restaurant Details
get_restaurant_details is the per-restaurant endpoint. It requires a restaurant_id (sourced from search_restaurants results partner_id or list_restaurants id) and an address for address-specific delivery calculations. The response includes delivery_fee in grosze (PLN minor units), minimum_order_value also in grosze, delivery_eta_min/delivery_eta_max in minutes, is_open, is_busy, rating, and rating_count. The currency field confirms PLN.
Coverage and Scope
All three endpoints resolve delivery context against a Polish address, so accuracy of delivery fee and ETA fields depends on the address supplied. The search_restaurants endpoint covers both restaurant-name and dish-name queries, returning a unified results array with a classification field to distinguish between the two result types. Restaurant IDs are consistent across endpoints, allowing search_restaurants or list_restaurants results to feed directly into get_restaurant_details.
- Find all open restaurants near a Warsaw address and filter by cuisine type from the
cuisinesfield. - Compare delivery ETAs and fees across multiple restaurants for a given delivery address.
- Check whether a specific restaurant is currently busy or closed before surfacing it to end users.
- Aggregate
ratingandrating_countdata across restaurants in a Polish city for market research. - Build a dish-search feature using the
queryparameter insearch_restaurantsto match dish names. - Track minimum order values across restaurants by polling
get_restaurant_detailsover time. - Resolve a free-text delivery address to geocoordinates using the
latitude/longitudefields returned by any endpoint.
| 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 Pyszne.pl have an official developer API?+
What does `search_restaurants` return beyond a list of restaurant names?+
results array includes name, classification (distinguishing restaurant vs. dish matches), partner_id, seo_name, subtitle, and image_url. The response also includes the geocoded latitude and longitude for the resolved delivery address and a total count of matches.Are menu items or dish-level prices available through the API?+
Is this API limited to a specific region of Poland?+
address input. Areas outside Pyszne.pl's delivery network will return fewer or no results. Cross-country coverage beyond Poland is not included since Pyszne.pl operates specifically in the Polish market.How are delivery fees represented in the response?+
delivery_fee and minimum_order_value in get_restaurant_details are returned as integers in grosze, the minor unit of Polish zloty (100 grosze = 1 PLN). The currency field confirms PLN. A null value for delivery_fee typically indicates free delivery or that the fee is unavailable for the requested address.