HungerStation APIhungerstation.com ↗
Access HungerStation restaurant data for Saudi Arabia: cities, neighborhoods, full menus with prices, ratings, and cuisine types via 5 structured endpoints.
What is the HungerStation API?
The HungerStation API gives structured access to Saudi Arabia's food delivery platform across 5 endpoints, covering cities, neighborhoods, and individual restaurant profiles including complete menus with item prices and discount fields. The get_restaurants_by_city endpoint returns paginated restaurant lists with ratings, cuisine types, location coordinates, and full menu breakdowns — all in a single call.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/77b0aebd-1e5f-4d91-9b11-aa6933c36428/get_cities' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns all cities served by HungerStation in Saudi Arabia. Each city includes its display name, URL slug for use with other endpoints, and the number of available restaurant pages (districts). The restaurant_count field represents the number of paginated result pages available for that city via get_restaurants_by_city.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer, total number of cities",
"cities": "array of city objects with city_name, city_slug, and restaurant_count"
},
"sample": {
"data": {
"total": 115,
"cities": [
{
"city_name": "Riyadh",
"city_slug": "riyadh",
"restaurant_count": 171
},
{
"city_name": "Jeddah",
"city_slug": "jeddah",
"restaurant_count": 112
},
{
"city_name": "Dammam",
"city_slug": "dammam",
"restaurant_count": 80
}
]
},
"status": "success"
}
}About the HungerStation API
City and Neighborhood Coverage
The get_cities endpoint returns every city HungerStation serves in Saudi Arabia, with each city object carrying a city_name, city_slug, and a restaurant_count that tells you how many paginated district pages exist for that city. Pass any city_slug (e.g. riyadh, jeddah, dammam) to list_neighborhoods to retrieve all districts within that city, including each neighborhood's slug, page index, latitude/longitude, and restaurant_count.
Restaurant Data and Menus
get_restaurants_by_city accepts a city_slug, an optional page (1-indexed, each page = one district), and an optional limit up to 50. Each restaurant object in the response includes name, rating, cuisine_type, logo, location (lat/lng), and a full categories array where every category holds its items — each item exposing item_id, name, description, price, pre_discount_price, and discount_percent. get_restaurants_by_neighborhood narrows the same result set to a specific district by accepting both city_slug and neighborhood (the slug from list_neighborhoods), filtering before fetching restaurant details so only matching results are returned.
Single Restaurant Lookup
get_restaurant_details takes a numeric restaurant_id (obtained from any listing endpoint) and returns the full branch profile: chain_id, cover_photo, status (e.g. OPEN/CLOSE), cuisine_type, delivery type, scheduled-order support, rating and rating count, and the complete categories → items menu tree. The item_count field gives the total number of menu items across all categories for quick validation.
Pagination Behavior
In get_restaurants_by_city and get_restaurants_by_neighborhood, the num_pages field in each response tells you how many pages exist at your current limit setting. Pages are 1-indexed. Because each page maps to one city district, iterating all pages of a city retrieves restaurants across all neighborhoods in sequence.
The HungerStation API is a managed, monitored endpoint for hungerstation.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when hungerstation.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official hungerstation.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a restaurant discovery app for Saudi Arabia using city and neighborhood slugs from
get_citiesandlist_neighborhoods - Aggregate menu prices and discount fields across Riyadh or Jeddah restaurants to analyze promotional patterns
- Map restaurant locations by extracting
latitude/longitudefrom neighborhood and restaurant objects - Track cuisine type distribution across cities using the
cuisine_typearray returned per restaurant - Monitor restaurant open/closed status using the
statusfield fromget_restaurant_details - Compile a calorie or pricing database by iterating menu
itemswithpriceanddescriptionfields - Compare chain presence across cities using
chain_idfrom individual restaurant profiles
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does HungerStation have an official public developer API?+
What does `get_restaurants_by_neighborhood` return that `get_restaurants_by_city` doesn't?+
get_restaurants_by_neighborhood accepts a neighborhood slug parameter and filters results to only that district before returning restaurant details. The response also includes a neighborhood field confirming the matched slug. get_restaurants_by_city pages through all districts in order without filtering, so it covers more restaurants per call but cannot target a single area.What does the `restaurant_count` field mean on city objects from `get_cities`?+
get_cities response, restaurant_count represents the number of paginated district pages available for that city, not a raw count of individual restaurant listings. Use get_restaurants_by_city with a specific page and check num_pages in the response to understand the full scope of available data for a given city.Does the API cover delivery time estimates or live order tracking?+
Are restaurants outside Saudi Arabia included?+
get_cities are Saudi Arabian cities. There is no coverage of other countries. If HungerStation expands its geographic footprint, you can fork the API on Parse and revise the city-discovery logic to include new regions.