Skip to content
Gridlode
Launching soonMaps and local businesses2 credits / business

Yellow Pages Business Search API

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.

GEThttps://api.gridlode.com/v1/places/yellowpages
Get an API keyReference docs
This engine is built but paused: Yellow Pages sits behind a Cloudflare challenge that blocks every proxy we have tried; we do not bypass it. Join early access through the contact form and we'll email you on launch day.

Parameters

NameTypeDescription
qrequiredstringCategory or keyword to search for, e.g. 'plumbers' or 'pizza'.
locationrequiredstringCity and state or ZIP code, e.g. 'Austin, TX' or '78701'.
pageintegerYellow Pages results page to start from (30 per page).
Default: 1
limitintegerMaximum businesses to return (1-300).
Default: 30
include_sponsoredbooleanAlso return sponsored (ad) listings, flagged as such.
Default: false
max_ageintegerAccept a cached answer up to this many seconds old, billed at 50%. Default 0 (always fresh).

Response fields

    Code

    curl "https://api.gridlode.com/v1/places/yellowpages?q=plumbers&location=Austin%2C%20TX&limit=30" \
  -H "Authorization: Bearer $GRIDLODE_KEY"
    2 credits per business
    One credit is $0.001 on the smallest pack, from $0.0003 on enterprise plans.
    Half price for cached data
    Cached for up to 336 h. Pass max_age to use it.
    Failed requests are free
    Blocks, timeouts and target errors never cost credits.

    Market reference: No public Yellow Pages API; per-result scrapers only.

    Questions

    How much does the Yellow Pages Business Search API cost?

    2 credits per business. One credit costs $0.001 on the smallest pack and as little as $0.0003 on enterprise plans. Cached answers cost half and failed calls are free.

    Maps and local businesses

    Related APIs in this category

    All 8 in Maps and local businesses · 6 live
    Live

    Google Maps Places Search

    Businesses and places from a Google Maps search, by query plus city ("dentists", "Austin, TX") or by exact coordinates and zoom

    2 credits / placeDocs
    Live

    BBB Business Search & Profiles

    Better Business Bureau (bbb.org) businesses in the US and Canada, searched by name or category plus city or ZIP, or one business profile by its BBB…

    2 credits / businessDocs
    Soon

    Angi Pro Search

    Home-service pros from Angi (angi.com) for a service and US ZIP code (or city and state, or any Angi directory URL)

    2 credits / businessDocs
    Live

    Bing Maps Places Search

    Local businesses from a Bing Maps search, by keyword plus city, ZIP or address ("plumbers", "Austin, TX") or around exact coordinates

    1 credit / businessTry freeDocs
    Live

    Google Maps Place Photos

    The photos and videos of one Google Maps place, by place ID or by name and city, that a signed-out visitor can see

    1 credit / requestDocs