yellowpages.com APIyellowpages.com ↗
Search US business listings, fetch contact info, hours, reviews, and categories from YellowPages.com via 7 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/2fc5523b-bc06-4c8c-8416-a3daa0e64f9f/search_businesses?limit=3&query=plumber&location=new+york+ny' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for businesses by keyword and location on YellowPages.com. Returns paginated results with up to 30 listings per page, supporting pagination up to page 17.
| Param | Type | Description |
|---|---|---|
| page | integer | Starting page number for pagination |
| limit | integer | Maximum number of results to return |
| queryrequired | string | Search keyword (e.g., 'plumber', 'restaurant', 'dentist') |
| locationrequired | string | Location to search in (e.g., 'new york ny', 'los angeles ca') |
{
"type": "object",
"fields": {
"total": "integer total number of listings returned",
"listings": "array of business listing objects with name, url, phone, address, categories, years_in_business, rating, review_count, and website"
},
"sample": {
"data": {
"total": 1,
"listings": [
{
"url": "https://www.yellowpages.com/nationwide/mip/best-home-savings-580143680?lid=1002194693877",
"name": "Best Home Savings",
"phone": null,
"rating": null,
"address": "Serving the New York area.",
"website": null,
"categories": [
"Plumbers",
"Water Heaters",
"Plumbing Contractors-Commercial & Industrial"
],
"review_count": null,
"years_in_business": null
}
]
},
"status": "success"
}
}About the yellowpages.com API
The YellowPages API covers 7 endpoints for searching and retrieving US business data from YellowPages.com. Use search_businesses to query by keyword and location and get back up to 30 listings per page — including name, phone, address, rating, review count, and website URL — or use get_business_details to fetch hours, amenities, categories, and description for a specific listing.
Search and Browse Businesses
The search_businesses endpoint accepts a required query (e.g., 'dentist', 'auto repair') and location (e.g., 'chicago il'), returning an array of listing objects. Each object carries name, phone, address, url, categories, years_in_business, rating, review_count, and website. Pagination is supported via the page parameter up to page 17, with up to 30 results per page. get_search_filters returns available filter options for a given query and location — for example, 'OPEN 24 Hours' — and nearby location refinements.
Business Details and Reviews
get_business_details takes a full YellowPages business URL and returns a richer object: hours (a map of day labels to time strings), email, amenities, description, and a categories array, in addition to contact fields. The optional check_pos parameter, when set to true, also returns technology signals detected on the business's own website. get_business_reviews takes the same URL format and returns an array of review objects, each with author, date, rating, title, and text.
Categories and Location Browsing
get_category_list returns all YellowPages business categories organized into named groups such as Home Services, Medical Services, and Auto Services — useful for building category-driven navigation. explore_cities returns a list of US states with associated URLs for browsing business listings by geography.
POS Technology Detection
check_pos_technology accepts any business website URL and returns has_pos (boolean), detected_pos_technologies (array of platform name strings), and the checked website URL. This endpoint is independent of a YellowPages listing and can be called directly against any URL.
- Build a local business directory app using
search_businessesfiltered by keyword and city - Aggregate business hours and contact details for a regional service-finder using
get_business_details - Monitor customer sentiment by collecting star ratings and review text via
get_business_reviews - Identify which restaurants or service businesses use specific POS platforms with
check_pos_technology - Populate category navigation menus from the structured groups returned by
get_category_list - Generate leads for B2B outreach by extracting phone, website, and years_in_business from search results
- Scope coverage of a market by browsing state-level business data starting from
explore_cities
| 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.com have an official developer API?+
What does `get_business_details` return beyond what `search_businesses` provides?+
get_business_details adds fields not present in search results: hours (a per-day map of opening times), email, amenities, description, and the optional check_pos technology signals. Search results include years_in_business and review_count but do not include hours or description.How far back do reviews go, and can I filter them by rating or date?+
get_business_reviews returns all reviews available on the YellowPages listing page for a given URL, with author, date, rating, title, and text per review. There is no built-in filter parameter for date range or minimum rating — the endpoint returns what the listing exposes. You can fork this API on Parse and add client-side filtering logic to the response.Does the API cover businesses outside the United States?+
explore_cities endpoint returns US states only. If you need international business directory data, you can fork this API on Parse and revise it to target a different directory source.