justdial.com APIjustdial.com ↗
Search Indian local businesses by city and category. Get names, phone numbers, ratings, addresses, reviews, and hours via the Justdial API.
curl -X GET 'https://api.parse.bot/scraper/8ae8199d-de08-4af0-94ee-6c8ac3d97f7a/search_businesses?city=Mumbai&page=1&keyword=Restaurants' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for businesses by city and keyword category (e.g., Caterers, Restaurants, Plumbers). Returns a paginated list of business listings with contact details, ratings, and location info. Pagination uses sequential page numbers; each page returns up to 10 results.
| Param | Type | Description |
|---|---|---|
| cityrequired | string | City name in India (e.g., Delhi, Mumbai, Bangalore). |
| page | integer | Page number for pagination. |
| keywordrequired | string | Category or business type to search for (e.g., Caterers, Restaurants, Plumbers, Electricians, Hotels, Packers and Movers, Dentists, Hospitals). |
{
"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": "Nanak Caterers and Decorators",
"slug": "DT-23XVQFMT",
"docid": "011PXX11.XX11.140712134438.Z7T7",
"phone": "+(91)-8105546376",
"rating": "4.6",
"address": "Vikaspuri",
"category": "Caterers",
"latitude": "28.6386438",
"locality": "Vikaspuri",
"verified": true,
"longitude": "77.07206",
"thumbnail": "https://images.jdmagicbox.com/v2/comp/delhi/t7/011pxx11.xx11.140712134438.z7t7/catalogue/nanak-caterers-and-decorators-vikaspuri-delhi-caterers-zfbmh5miqs-t.jpg",
"rating_count": "211",
"working_hours": "OPEN NOW | 9:00 am - 12:00 am"
}
],
"total_results": 10
},
"status": "success"
}
}About the justdial.com API
The Justdial API provides access to India's local business directory across 4 endpoints, returning structured data including contact details, ratings, addresses, and customer reviews. The search_businesses endpoint accepts any city name and keyword category — restaurants, plumbers, electricians, and more — and returns paginated listings with latitude and longitude coordinates, phone numbers, and rating counts.
What the API Returns
The core search_businesses endpoint takes a city and keyword parameter (for example, city=Mumbai, keyword=Electricians) and returns up to 10 listings per page. Each result includes name, docid, address, locality, rating, rating_count, phone, category, latitude, and long. The page parameter enables sequential pagination. The total_results field reflects the count for the current page, not the total across all pages.
Business Detail and Specialty Endpoints
Once you have a docid and slug from search results, pass them to get_business_details to retrieve a fuller record: email, website, pincode, landmark, latitude, and a reviews array containing user-submitted feedback. Two convenience endpoints — search_doctors and search_caterers — behave identically to search_businesses with their respective keywords pre-filled, accepting only a city input and returning the same listing object shape.
Coverage and Scope
All endpoints are scoped to Indian cities. The city parameter accepts major metro names (Delhi, Bangalore, Chennai) as well as smaller Indian cities. The keyword field in search_businesses maps to Justdial's business categories, so terms like Hotels, Packers and Movers, or Caterers return category-matched results. The docid format follows Justdial's internal identifier pattern and is required alongside the slug to fetch business-level detail.
- Build a vendor comparison tool for Indian catering services using
rating,rating_count, andphonefields fromsearch_caterers. - Aggregate doctor listings by city for a healthcare referral directory using
search_doctorswith address and contact data. - Enrich a CRM with local supplier contact details by running
search_businessesacross multiple Indian cities and business categories. - Display location-aware business results on a map using
latitudeandlongcoordinates from search results. - Pull customer review text via
get_business_detailsto monitor reputation across local service providers. - Generate leads for B2B outreach by collecting business
email,website, andphonefields from the detail endpoint. - Cross-reference pincode data from
get_business_detailsagainst delivery zone logic for logistics planning.
| 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 | 250 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 have an official developer API?+
What does `get_business_details` return that `search_businesses` does not?+
get_business_details adds several fields not present in search results: email, website, pincode, landmark, and a reviews array with individual customer feedback. It requires both the docid and slug, which you obtain from a prior search_businesses call.Does the API support filtering search results by rating, distance, or price range?+
search_businesses accepts only city, keyword, and page — there are no filter parameters for minimum rating, proximity radius, or price tier. You can fork the API on Parse and revise it to add filtering logic on top of the returned results.How does pagination work, and can I get a total result count across all pages?+
search_businesses uses sequential integer page numbers via the page parameter, returning up to 10 results per page. The total_results field reflects the count on the current page only, not the full dataset. To know how many pages exist, you need to step through pages until results run short.Does the API cover business listings outside India?+
city parameter expects an Indian city name. Justdial itself operates only in India, so international business lookups are not available. You can fork the API on Parse and revise it to point at a different directory source for non-Indian coverage.