Skip to content
Gridlode
Docs · Reference

BBB Business Search & Profiles

GET /v1/places/bbb2 credits / businesscache 10080 min

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.

Query parameters

q
string
Business name or category to search for, e.g. 'plumbers' or 'Crow's Plumbing'.
Default: null
location
string
City and state/province or ZIP/postal code, e.g. 'Austin, TX' or '78701'.
Default: null
country
string
Search the US (us) or Canadian (ca) BBB directory.
Default: "us"
Allowed: us, ca
profile_url
string
A bbb.org business profile URL. Returns that one business instead of searching.
Default: null
sort
string
Result order.
Default: "relevance"
Allowed: relevance, distance, rating, a_z
page
integer
BBB results page to start from (15 businesses per page).
Default: 1
limit
integer
Maximum businesses to return (1-150).
Default: 15
accredited_only
boolean
Keep only BBB-accredited businesses.
Default: false
details
boolean
Open each business's profile for website, years in business, complaints and more. Each business is then billed twice.
Default: false
include_contact_names
boolean
Return the names of business principals listed on profiles. Off by default: only their titles.
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/bbb?q=plumbers&location=Austin%2C%20TX&limit=15" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the BBB Business Search & Profiles API page.