Justdial APIjustdial.com ↗
Search Justdial India for caterers and event businesses by city. Returns names, phone numbers, ratings, addresses, and coordinates for up to 10 listings per page.
What is the Justdial API?
The Justdial API provides access to local business listings across Indian cities through 2 endpoints, returning up to 10 results per call with fields including business name, phone number, rating, rating count, address, locality, and GPS coordinates. The search_caterers endpoint targets catering and event service providers directly, while search_businesses accepts a city and keyword parameter for broader category searches.
curl -X GET 'https://api.parse.bot/scraper/8ae8199d-de08-4af0-94ee-6c8ac3d97f7a/search_businesses?city=Delhi&page=1&keyword=Caterers' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace justdial-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Justdial SDK — search caterers and event businesses in Indian cities."""
from parse_apis.justdial_caterers_events_directory_api import Justdial, Business, City, NotFoundError
justdial = Justdial()
# Search for caterers in Delhi using the general search with pagination
for business in justdial.businesses.search(city="Delhi", keyword="Caterers", limit=5):
print(business.name, business.rating, business.phone, business.locality, business.verified)
# Use the City construct to find caterers in Mumbai directly
mumbai = justdial.city("Mumbai")
for caterer in mumbai.caterers(limit=3):
print(caterer.name, caterer.address, caterer.rating_count, caterer.working_hours)
# Drill-down: take one item with .first()
top_result = justdial.businesses.search(city="Bangalore", keyword="Caterers", limit=1).first()
if top_result:
print(top_result.name, top_result.docid, top_result.category, top_result.slug)
# Typed error handling
try:
for biz in justdial.businesses.search(city="Delhi", keyword="Caterers", limit=2):
print(biz.name, biz.phone)
except NotFoundError as exc:
print(f"not found: {exc}")
print("exercised: businesses.search / city.caterers / .first() drill-down / error handling")
Search for catering and event businesses by city and keyword category. Returns a paginated list of business listings with contact details, ratings, and location info. Each page returns up to 10 results. The underlying API is optimized for the Caterers category; other keywords may return empty results.
| Param | Type | Description |
|---|---|---|
| cityrequired | string | City name in India (e.g., Delhi, Mumbai, Bangalore, Chennai, Hyderabad). |
| page | integer | Page number for pagination. |
| keywordrequired | string | Category or business type to search for. Reliably supported: 'Caterers'. Other food/event keywords may work depending on the city. |
{
"type": "object",
"fields": {
"city": "string - city searched",
"page": "integer - current page number",
"keyword": "string - keyword searched",
"results": "array of business listing objects with name, docid, address, locality, city, rating, rating_count, phone, category, latitude, longitude, verified, working_hours, thumbnail, slug",
"total_results": "integer - number of results on this page"
},
"sample": {
"data": {
"city": "Delhi",
"page": 1,
"keyword": "Caterers",
"results": [
{
"city": "delhi",
"name": "Kripa Events & Caterers",
"slug": "DT-23PT1VE5ABA",
"docid": "011PXX11.XX11.250130195050.M2V8",
"phone": "+(91)-7795892636",
"rating": "4.8",
"address": "Amarpali Dream Valley Techzone 4",
"category": "Caterers",
"latitude": "28.5924446",
"locality": "Techzone 4",
"verified": true,
"longitude": "77.442286",
"thumbnail": "https://images.jdmagicbox.com/v2/comp/delhi/v8/011pxx11.xx11.250130195050.m2v8/catalogue/cook-s-haven-ek-murti-chowk-ghaziabad-caterers-ugc7s15n9l-t.jpg",
"rating_count": "104",
"working_hours": "OPEN NOW | 7:00 am - 12:15 am"
}
],
"total_results": 10
},
"status": "success"
}
}About the Justdial API
What the API Returns
Both endpoints return arrays of business listing objects sourced from Justdial, India's local business directory. Each listing object includes name, docid, address, locality, city, rating, rating_count, phone, category, latitude, and longitude. The total_results field tells you how many listings were returned in the current page, and the page field tracks your position in paginated result sets.
Endpoints and Parameters
search_caterers takes a single required city parameter (e.g., Delhi, Mumbai, Bangalore, Chennai, Hyderabad) and always returns the first page of caterer listings — no keyword or pagination input needed. search_businesses is the more flexible endpoint: it accepts city, keyword, and an optional page integer for paginating through results. The keyword parameter is optimized for the value Caterers; other food and event-related keywords may return results but behavior is less predictable outside that category.
Coverage and Limitations
Coverage is limited to cities in India. Results are paginated at up to 10 listings per call; use the page parameter in search_businesses to retrieve subsequent pages. Working hours data is referenced in the search_caterers endpoint description but availability may vary by listing. Phone numbers and addresses reflect what is present in Justdial's directory at the time of the request — not all listings include every field.
The Justdial API is a managed, monitored endpoint for justdial.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when justdial.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 justdial.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 caterer comparison tool for Indian wedding planners using rating, rating_count, and phone fields
- Populate a city-specific vendor directory with addresses and locality data from search_caterers
- Geocode catering businesses onto a map using the latitude and longitude fields returned per listing
- Generate leads for event supply companies by extracting phone numbers and business names by city
- Monitor caterer listings across multiple Indian cities by paginating through search_businesses results
- Enrich a CRM with verified business contact data for food and event service providers in India
| 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 Justdial have an official public developer API?+
What does the search_businesses endpoint return beyond what search_caterers provides?+
keyword parameter and a page integer for pagination, so you can retrieve results beyond the first 10 and experiment with other food or event category terms. search_caterers is fixed to page 1 and the Caterers keyword.Can I search for business types other than caterers, like florists or wedding venues?+
Does the API return reviews or review text from individual customers?+
rating and rating_count fields per listing, but individual user review content is not currently included. You can fork the API on Parse and revise it to add a review-detail endpoint if per-review text is needed.