HungerStation APIhungerstation.com ↗
Access HungerStation restaurant data across Saudi Arabian cities. Browse cities, neighborhoods, full menus, ratings, and cuisine types via 4 structured endpoints.
What is the HungerStation API?
The HungerStation API provides structured access to Saudi Arabia's food delivery platform across 4 endpoints, covering cities, neighborhoods, restaurants, and complete menus with prices. The get_restaurants_by_city endpoint returns full restaurant profiles including ratings, cuisine types, logos, and itemized menus for every restaurant in a given city district. City slugs from get_cities chain directly into restaurant and neighborhood lookups.
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 restaurant_count representing the number of paginated district pages available. Pass any city_slug (e.g. riyadh, jeddah, dammam) to list_neighborhoods to get all districts within that city, including each neighborhood's slug, page index, latitude, longitude, and restaurant_count.
Restaurant and Menu Data
get_restaurants_by_city accepts a city_slug and optional page and limit parameters (max 50 restaurants per call). Each restaurant object in the response includes its name, ID, location, rating, cuisine type, logo URL, and a complete menu with item names and prices. get_restaurants_by_neighborhood works similarly but filters results to a specific district before fetching details, using the neighborhood slug obtained from list_neighborhoods. This makes targeted queries more efficient since irrelevant restaurants are excluded before detailed data is fetched.
Pagination Behavior
Both restaurant endpoints return num_pages alongside the current page and total_count fields, so you can iterate through all results programmatically. Each page in get_restaurants_by_city corresponds to one district within the city. For cities with many districts, iterating by neighborhood via get_restaurants_by_neighborhood is the more granular approach and avoids fetching irrelevant data. list_neighborhoods returns the exact page index for each neighborhood, which cross-references directly with get_restaurants_by_city.
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 menu aggregator comparing item prices across restaurants in a given Riyadh neighborhood using
get_restaurants_by_neighborhood. - Map restaurant density per district by combining
list_neighborhoodslatitude/longitude fields with restaurant counts. - Track cuisine type availability city-by-city using the cuisine field from
get_restaurants_by_cityresponses. - Populate a food delivery comparison tool with live menu prices and restaurant ratings for major Saudi cities.
- Monitor which neighborhoods in Jeddah or Dammam have the highest restaurant counts using
list_neighborhoods. - Aggregate restaurant logo assets and metadata for a directory app covering HungerStation's full Saudi coverage.
- Analyze menu pricing distributions across different city districts using itemized menu data from restaurant objects.
| 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 the `get_restaurants_by_city` endpoint return for each restaurant?+
page and limit parameters, and the response includes num_pages and total_count for iterating the full result set.What is the difference between `get_restaurants_by_city` and `get_restaurants_by_neighborhood`?+
get_restaurants_by_city returns all restaurants for a city page, where each page corresponds to one district. get_restaurants_by_neighborhood accepts an explicit neighborhood slug and filters to only that district before fetching detailed restaurant data, making it more efficient when you only need one area. Neighborhood slugs are obtained from list_neighborhoods.