Skip to content
Gridlode
Docs · Reference

Yellow Pages Business Search

GET /v1/places/yellowpages2 credits / businesscache 20160 min

Businesses from a yellowpages.com search by category or keyword plus city, state or ZIP ("plumbers", "Austin, TX"): business name, categories, phone, street address, city, state and ZIP, website, star rating and review count, the TripAdvisor rating YP shows, years in business, thumbnail and the YP listing URL, 30 businesses per YP page and up to 300 per call. Sponsored listings are left out unless you ask for them. Collected as a signed-out visitor; bot-check pages are detected, never bypassed, and never charged. Billed per business returned; blocked or failed requests are free.

Query parameters

q
string · required
Category or keyword to search for, e.g. 'plumbers' or 'pizza'.
location
string · required
City and state or ZIP code, e.g. 'Austin, TX' or '78701'.
page
integer
Yellow Pages results page to start from (30 per page).
Default: 1
limit
integer
Maximum businesses to return (1-300).
Default: 30
include_sponsored
boolean
Also return sponsored (ad) listings, flagged as such.
Default: false
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/places/yellowpages?q=plumbers&location=Austin%2C%20TX&limit=30" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the Yellow Pages Business Search API page.