yellowpages.in APIyellowpages.in ↗
Search Indian businesses, get contact details, coordinates, opening hours, and category listings from YellowPages.in via a structured REST API.
curl -X GET 'https://api.parse.bot/scraper/5ec3b974-cf29-4a9d-a9bf-8e61fa71d1c6/search_businesses?limit=5&query=plumbers&location=Hyderabad' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for businesses by keyword and location. Returns a list of businesses matching the query in the specified city, parsed from the YellowPages.in listing page.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of business results to return. |
| queryrequired | string | Business type or keyword to search for (e.g. 'plumbers', 'hotels', 'restaurants'). |
| locationrequired | string | City or area to search in (e.g. 'Hyderabad', 'Delhi', 'Mumbai'). |
{
"type": "object",
"fields": {
"query": "string — the search query used",
"location": "string — the location searched",
"businesses": "array of business objects with name, url, phone, address, email, and rating",
"total_results": "integer — total number of results found on the listing page"
},
"sample": {
"data": {
"query": "plumbers",
"location": "Hyderabad",
"businesses": [
{
"url": "http://www.yellowpages.in/b/perfect-plumbtech-hyder-shah-kote-hyderabad/413953573",
"name": "Perfect Plumbtech",
"email": "[email protected]",
"phone": "+1 (555) 012-3456",
"rating": "0.0",
"address": "123 Main St, Springfield, IL 62704"
}
],
"total_results": 13
},
"status": "success"
}
}About the yellowpages.in API
The YellowPages.in API provides access to India's business directory through 4 endpoints, returning business listings with phone numbers, email addresses, coordinates, and opening hours. The search_businesses endpoint accepts a keyword and city to return matching businesses across India, while get_business_detail returns full contact info, timings, and geolocation for a single listing.
What the API Covers
The YellowPages.in API exposes four endpoints that cover searching, detail retrieval, autocomplete, and category browsing for businesses listed on the Indian YellowPages directory. The search_businesses endpoint takes a required query (e.g. 'hotels', 'plumbers') and location (e.g. 'Mumbai', 'Delhi') and returns an array of business objects, each with name, url, phone, address, email, and rating. An optional limit parameter controls how many results come back. The total_results field reflects the count reported on the listing page.
Business Detail and Autocomplete
To go deeper on any listing, pass its url path — obtainable from search_businesses results — to get_business_detail. The response adds website, timings (a map of day names to time ranges), and coordinates with lat and lng strings, fields not present in the search listing. Both email and website are nullable; timings and coordinates are returned as null when the business hasn't published that information. The get_search_autocomplete endpoint accepts a partial query and a location and returns suggestions typed as either 'category' or 'business', each with a text, url, and optional area field — useful for building search-as-you-type interfaces.
Category Browsing
The list_categories endpoint takes no inputs and returns the full set of business categories available on YellowPages.in — hundreds of entries, each with a name and a url pointing to its listing page. This is the right starting point for enumerating verticals or seeding a batch search across specific sectors.
- Build a B2B lead list by searching a keyword like 'manufacturers' across multiple Indian cities using
search_businesses - Enrich a CRM record with verified phone, email, and website by calling
get_business_detailon a known business URL - Map business locations by extracting
coordinatesfromget_business_detailto plot on a geo visualization - Power a search-as-you-type field for Indian business discovery using
get_search_autocompletesuggestions - Audit operating hours for a set of service businesses by parsing the
timingsobject returned byget_business_detail - Enumerate all industry verticals available on YellowPages.in using
list_categoriesto drive a category-browsing UI - Cross-reference Indian business contact data — phone, email, address — against another directory for deduplication
| 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 YellowPages.in have an official developer API?+
What does `get_business_detail` return that `search_businesses` does not?+
get_business_detail adds website, timings (a day-by-day hours map), and coordinates (lat/lng strings). The search endpoint returns only name, url, phone, address, email, and rating. To get hours or map coordinates for a listing you must make a separate get_business_detail call using the url from the search result.Does the API support pagination through multi-page search results?+
search_businesses endpoint returns results from the listing page and exposes a total_results count, but does not currently accept a page or offset parameter for fetching subsequent pages. The limit parameter controls how many items are returned from the first page of results. You can fork this API on Parse and revise it to add pagination support.Does the API cover businesses across all Indian cities?+
location value you supply. There is no built-in list of supported cities; results vary by how densely a city is indexed in the directory. Smaller towns may return fewer or no results for a given query.Can I retrieve user reviews or ratings detail for a business?+
search_businesses endpoint returns a rating field at the listing level, but neither endpoint currently returns individual user reviews, review counts, or review text. You can fork this API on Parse and revise it to add a reviews endpoint that pulls review data from business detail pages.