Written by the IndiaRestros team. This is a how-to for our own free API, so it covers what it does and what it does not.
IndiaRestros is an open restaurant graph for India: about 17 lakh restaurants, cafes, bakeries, dhabas, bars and street stalls in 9,800+ cities and towns. Each place has a permanent id (IRR-XXXXXXXXXX), address, map point, phone, timings, cuisines, price for two and, where known, a menu with item prices and veg marks. Reads are free and need no key and no sign-up.
This guide shows the two calls most builders need: restaurant search and dish-price search.
The endpoints at a glance
| What you want | Call | Key params |
|---|---|---|
| Restaurants by name, cuisine or area | GET https://indiarestros.com/api/v1/restaurants |
q, city, locality, lat, lon, radius_m, cuisine, diet=veg, open_now=true |
| A dish with prices across menus | GET https://indiarestros.com/api/v1/dishes |
q, city, veg=true, max_price |
| Full spec | OpenAPI | — |
| Human docs | API reference | — |
City and area values are slugs: bengaluru, mumbai, delhi, hyderabad, pune; indiranagar, bandra-west, kondapur.
1. Find restaurants
curl "https://indiarestros.com/api/v1/restaurants?q=biryani&city=hyderabad&locality=kondapur"
Each result carries the id, name, cuisines, locality and city, lat/lon, phone, cost_for_two, hours, open_now, service flags (dine-in, takeaway, delivery, each with its source) and a canonical url such as https://indiarestros.com/r/<name-area-code>. The response also has a ranking note: payment never affects order (how we rank).
2. Search a dish and its price
curl "https://indiarestros.com/api/v1/dishes?q=masala+dosa&city=bengaluru&max_price=120"
A result looks like this (trimmed, real output):
{
"name": "Cheese Masala Dosa",
"section": "DOSA",
"price": 75,
"veg": true,
"dish": "cheese-masala-dosa",
"r_name": "Anagha Grand",
"locality": "Subramanyapura",
"city": "Bengaluru",
"restaurant_url": "https://indiarestros.com/r/anagha-grand-subramanyapura-3fjsmkmxe3",
"currency": "INR"
}
dish is a canonical dish slug, so the same dish links across restaurants. The dish catalog shows where to eat each dish and what it costs, India-wide and by city.
3. Python in ten lines
import requests
r = requests.get("https://indiarestros.com/api/v1/dishes",
params={"q": "paneer butter masala", "city": "pune",
"veg": "true", "max_price": 300}, timeout=30)
for d in r.json()["results"][:5]:
print(d["price"], d["name"], "-", d["r_name"], d["locality"], d["restaurant_url"])
4. Or connect it as an MCP server
If you build with Claude, ChatGPT, Cursor or another MCP client, skip the REST calls and add the server: https://indiarestros.com/mcp (Streamable HTTP, no auth). Tools: search_restaurants, get_restaurant, search_dishes, get_menu, list_places, get_place, report_correction, about_dataset.
claude mcp add --transport http indiarestros https://indiarestros.com/mcp
Good practice
- Cite the restaurant URL in anything you show users.
- Prices and timings change. Fields carry
srcand observed dates, so say where a fact came from when it matters. - Any page is also available as Markdown with
Accept: text/markdown. - Found a wrong phone or closed outlet? Use
report_correction.
FAQ
Is the IndiaRestros API free? Yes. Reads need no key, no account and no payment.
Does it cover small towns? Yes, 9,800+ cities and towns, not just metros, though menu depth is better in big cities.
Can I filter vegetarian dishes? Yes: veg=true on dish search, diet=veg on restaurant search.
Where are the docs? indiarestros.com/api/docs and indiarestros.com/for-agents.