Skip to main content
Network status
Log in
Piloterr
Back to library

Yellowpages Search API

Search Yellow Pages businesses from a full search URL and retrieve names, phones, addresses, ratings, opening hours, and pagination via browser rendering.

Active2 credits = 1 requestGET/v2/yellowpages/search
Try endpoint for freePiloterr

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

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.

QuickstartLink to Quickstart

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.

Supported URL formatsLink to Supported URL formats

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

ParametersLink to Parameters

Parameter Type Required Description
query string yes Full Yellow Pages search URL

Response fieldsLink to Response fields

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

NotesLink to Notes

  • 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.

Main use casesLink to Main use cases

  • 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

Related APIs

Expand your data capabilities with these complementary tools.

View All
Yellowpages Business/v2/yellowpages/business

Extract a full Yellow Pages business profile from a listing URL, including phone, website, categories, and ratings via browser rendering.

GET2 credits = 1 requestActive

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included
Start free (+500 credits)PiloterrTalk to a data expert