Skip to content
Gridlode
LiveMaps and local businesses2 credits / business

BBB Business Search & Profiles API

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 URL: name, BBB accreditation, letter rating (A+ to F), address, coordinates, phone, website, categories, years in business, complaint counts (total, closed in the last 12 months and 3 years), customer review count and star average, licences, payment methods, service areas and the profile URL. Search results come 15 per BBB page; set details=true to open every business's profile for the full field set (billed as two businesses each). Collected exactly as a signed-out visitor sees bbb.org; names of business principals are withheld unless you ask for them, and e-mail addresses are never collected. Billed per business returned; blocked or failed requests are free. Note: BBB currently puts its profile pages behind a bot check for automated visitors, so profile_url lookups and details=true usually come back blocked (free); search results are unaffected.

GEThttps://api.gridlode.com/v1/places/bbb
Get an API keyReference docs

Parameters

NameTypeDescription
qstringBusiness name or category to search for, e.g. 'plumbers' or 'Crow's Plumbing'.
Default: null
locationstringCity and state/province or ZIP/postal code, e.g. 'Austin, TX' or '78701'.
Default: null
countrystringSearch the US (us) or Canadian (ca) BBB directory.
Default: "us"
One of: us, ca
profile_urlstringA bbb.org business profile URL. Returns that one business instead of searching.
Default: null
sortstringResult order.
Default: "relevance"
One of: relevance, distance, rating, a_z
pageintegerBBB results page to start from (15 businesses per page).
Default: 1
limitintegerMaximum businesses to return (1-150).
Default: 15
accredited_onlybooleanKeep only BBB-accredited businesses.
Default: false
detailsbooleanOpen each business's profile for website, years in business, complaints and more. Each business is then billed twice.
Default: false
include_contact_namesbooleanReturn the names of business principals listed on profiles. Off by default: only their titles.
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/bbb?q=plumbers&location=Austin%2C%20TX&limit=15" \
  -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 168 h. Pass max_age to use it.
    Failed requests are free
    Blocks, timeouts and target errors never cost credits.

    Market reference: No public BBB business-data API.

    Questions

    Part of these solutions
    How much does the BBB Business Search & Profiles 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
    Soon

    Yellow Pages Business Search

    Businesses from a yellowpages.com search by category or keyword plus city, state or ZIP ("plumbers", "Austin, TX")

    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