Justdial APIjustdial.com ↗
Access Justdial India business listings via API. Search caterers, doctors, and local services by city. Returns contact info, ratings, reviews, and addresses.
What is the Justdial API?
The Justdial API exposes 4 endpoints for querying local Indian business listings across categories like caterers and doctors. The search_businesses endpoint returns up to 10 paginated results per call, each including business name, phone number, rating, rating count, address, locality, latitude/longitude, and a unique docid that can be passed to get_business_details for full records including email, website, reviews, and pincode.
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
The search_businesses endpoint accepts a required city and keyword parameter, returning an array of listing objects. Each object includes name, docid, address, locality, city, rating, rating_count, phone, category, latitude, and longitude. The keyword parameter is optimized for 'Caterers'; other food and event-related terms may return results but are not guaranteed. Pagination is supported via the page parameter, with each page capped at 10 results.
Convenience Endpoints
search_caterers and search_doctors are purpose-built shortcuts. search_caterers accepts only a city and always queries the Caterers category, returning the same fields as search_businesses. search_doctors similarly targets the Doctors keyword. Both always return page 1 and set total_results to the count of records in that response.
Business Detail Records
get_business_details requires three inputs: city, slug (the URL identifier from a Justdial listing), and docid (the unique document ID returned by search endpoints). It returns extended fields not available in search results: email, website, pincode, landmark, and a reviews array of customer review objects, in addition to core fields like name, phone, rating, address, and latitude.
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 catering vendor directory for a city, pulling contact info and ratings from
search_caterers. - Enrich a CRM with verified phone numbers and addresses for local Indian businesses using
get_business_details. - Aggregate customer review data for sentiment analysis across caterers in multiple Indian cities.
- Power a local service discovery app with business locations via the
latitudeandlongitudefields. - Generate leads for event planning services by iterating
search_businessesacross cities with theCatererskeyword. - Validate or supplement business contact records using
email,website, andpincodefromget_business_details. - Compare ratings and review counts across doctors in a given city using
search_doctors.
| 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 | 100 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 Justdial offer an official developer API?+
What does `get_business_details` return that search endpoints do not?+
get_business_details adds email, website, pincode, landmark, and a reviews array to the core fields. To call it you need both the slug (from a Justdial listing URL) and the docid returned by search_businesses, search_caterers, or search_doctors.Which keyword categories are reliably supported in `search_businesses`?+
keyword parameter is confirmed to work reliably with 'Caterers'. Other food and event-related keywords may return results, but behavior is not guaranteed. The dedicated search_doctors endpoint covers the Doctors category. You can fork this API on Parse and revise it to test and stabilize additional keyword categories.Does the API cover cities outside of India or support filtering by pincode or neighborhood?+
city parameter accepts Indian city names only. Results can't currently be filtered by pincode, neighborhood, or radius. You can fork this API on Parse and revise it to add a neighborhood or pincode filter if the underlying data supports it.Is there a way to retrieve more than 10 results for a city search?+
search_businesses returns up to 10 results per page. To retrieve more listings, increment the page parameter across successive calls. The search_caterers and search_doctors endpoints always return page 1 only and do not expose a pagination parameter. You can fork this API on Parse and revise those endpoints to expose pagination.