YellowPages APIyellowpages.in ↗
Search Indian businesses, get contact details, coordinates, opening hours, and category listings from YellowPages.in via a structured REST API.
What is the YellowPages 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.
curl -X GET 'https://api.parse.bot/scraper/5ec3b974-cf29-4a9d-a9bf-8e61fa71d1c6/search_businesses?limit=10&query=plumbers&location=Hyderabad' \ -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 yellowpages-in-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.
from parse_apis.yellowpages_india_api import YellowPages, Business, BusinessSummary, Category, Suggestion
client = YellowPages()
# Search for plumbers in Hyderabad
for business in client.businesssummaries.search(query="plumbers", location="Hyderabad"):
print(business.name, business.phone, business.address)
# Get full details for each business
detail = business.details()
print(detail.name, detail.phone, detail.address, detail.website)
if detail.coordinates:
print(detail.coordinates.lat, detail.coordinates.lng)
# Autocomplete suggestions
for suggestion in client.suggestions.search(query="rest", location="Mumbai"):
print(suggestion.text, suggestion.type, suggestion.area)
# List all categories
for category in client.categories.list():
print(category.name, category.url)
# Get a specific business by URL path
biz = client.businesses.get(url="/b/nasir-ali-plumber-bahadurpura-hyderabad/290211885")
print(biz.name, biz.phone, biz.address)
Search for businesses by keyword and location. Uses the site's category search to find matching businesses in the specified Indian city. Returns structured business listings with contact information. The query must match a known category on the site; use get_search_autocomplete to discover valid category terms. Returns up to ~25 results for a single category match.
| 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 API
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.
The YellowPages API is a managed, monitored endpoint for yellowpages.in — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when yellowpages.in 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 yellowpages.in 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 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 | 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 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.