Extract business listing cards from any Yellow Pages search results page. Returns structured results with name, phone, address components, ratings, review counts, opening hours, and pagination metadata.
Yellow Pages search pages are JavaScript single-page applications. Listing cards load dynamically after the initial HTML shell. A plain HTTP request returns an empty page skeleton. Piloterr uses website rendering to execute JavaScript, wait for business cards to render, and extract structured JSON from the live DOM.
GET https://api.piloterr.com/v2/yellowpages/search?query=https://www.yellowpages.com/los-angeles-ca/plumbers
Copy the full URL from yellowpages.com. Use ?page=2 or pagination.next_url for pagination.
| Format |
Example |
| Category in city |
https://www.yellowpages.com/los-angeles-ca/plumbers |
| Paginated search |
https://www.yellowpages.com/los-angeles-ca/plumbers?page=2 |
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Full Yellow Pages search URL |
| Field |
Type |
Description |
results |
array |
Business listing cards |
results[].url |
string |
Business profile URL |
results[].name |
string |
Business name |
results[].phone |
string | null |
Formatted phone number |
results[].street_address |
string | null |
Street line |
results[].address_locality |
string | null |
City |
results[].address_region |
string | null |
State code |
results[].postal_code |
string | null |
ZIP code |
results[].address_country |
string | null |
Country code |
results[].rating_value |
number | null |
Average rating (0-5) |
results[].review_count |
integer | null |
Number of reviews |
results[].opening_hours |
array |
Opening hours strings (Schema.org format) |
pagination.current |
integer |
Current page number |
pagination.next |
integer | null |
Next page number |
pagination.next_url |
string | null |
Next page URL |
pagination.total_pages |
integer |
Total pages |
pagination.total_count |
integer |
Total matching listings |
pagination.per_page |
integer |
Results on this page |
pagination.other_pages |
array |
Other page numbers |
pagination.has_next_page |
boolean |
Whether a next page exists |
- Targets yellowpages.com (US).
opening_hours and rating fields may be absent on some cards.- Pass
results[].url to Yellowpages Business for website, categories, and full rating details.
- Build local business lead lists by category and city
- Monitor competitor ratings and review counts at scale
- Feed sales prospecting tools with Yellow Pages search cards
- Paginate through Yellow Pages result pages programmatically
