bbb.org APIbbb.org ↗
Search BBB-listed businesses, retrieve full contact profiles, and fetch customer reviews. 3 endpoints covering name, address, rating, and review text.
curl -X GET 'https://api.parse.bot/scraper/9f856b0d-568d-4aff-904a-82d457aaafcf/search_businesses?page=1&query=plumber&location=new+york' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for businesses on BBB by keyword and location. Returns a paginated list of business summaries including name, address, phone, category, and BBB profile URL. Location influences the regional BBB results but may not strictly filter to the exact city specified.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search keyword such as business name, category, or service type. |
| locationrequired | string | Location to search near, such as a city and state or ZIP code. |
{
"type": "object",
"fields": {
"page": "string indicating the current page number",
"businesses": "array of business summary objects with Business Name, Phone Number, City, State, Category Label, BBB Profile URL, and Full Address"
},
"sample": {
"data": {
"page": "1",
"businesses": [
{
"City": "Knoxville",
"State": "IA",
"Full Address": "123 Main St, Springfield, IL 62704",
"Phone Number": "+1 (555) 012-3456",
"Business Name": "Brookwood Inc",
"Category Label": "Heating and Air Conditioning, Plumber, Air Conditioning Contractors ...",
"BBB Profile URL": "https://www.bbb.org/us/ia/knoxville/profile/heating-and-air-conditioning/brookwood-inc-0664-6001292/addressId/3102"
}
]
},
"status": "success"
}
}About the bbb.org API
The BBB.org API provides access to business directory and review data from the Better Business Bureau across 3 endpoints. With search_businesses, you can query by keyword and location to get paginated summaries including business name, phone, address, and BBB profile URL. The other endpoints pull full contact profiles and customer reviews for any business in the BBB directory.
What the API Covers
The BBB.org API exposes three endpoints that map to the core data surfaces on bbb.org: business search, business profiles, and customer reviews. Each business record is identified by its BBB profile URL, which flows from search_businesses into get_business_profile and get_business_reviews as the primary key.
Searching and Identifying Businesses
search_businesses accepts a query string (business name, category, or service type) and a location (city/state or ZIP code). Results are paginated via the page parameter and return an array of business summary objects. Each summary includes Business Name, Phone Number, City, State, Full Address, Category Label, and the BBB Profile URL. Note that location influences which regional BBB results are surfaced but does not always strictly filter to the exact city specified.
Business Profiles and Reviews
get_business_profile takes a BBB profile URL and returns a fuller contact record: Street Address, City, State, ZIP Code (including ZIP+4 when available), Owner Name, Owner Email, Website URL, Phone Number, Business Name, and Business Type classification. One known quirk: social media URLs in the profile may reflect BBB's own accounts rather than the specific business's social presence.
get_business_reviews also takes a BBB profile URL and returns paginated customer reviews. Each review object contains Reviewer Name, Review Date, Rating, and Review Text. Businesses with no submitted reviews return an empty array rather than an error.
- Build a local business reputation dashboard by combining star ratings and review text from
get_business_reviews - Verify business contact details — address, phone, owner name — before entering a vendor relationship
- Compile category-specific business directories by searching with service-type keywords in
search_businesses - Monitor review sentiment over time by periodically fetching paginated reviews for a tracked set of profile URLs
- Enrich a CRM with BBB-sourced business type classification and owner email from
get_business_profile - Cross-check business website URLs and physical addresses for lead qualification pipelines
- Aggregate BBB-listed businesses by ZIP code to analyze service provider density in a given market
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does BBB.org have an official developer API?+
What does `get_business_profile` return beyond what `search_businesses` already provides?+
search_businesses returns a summary: Business Name, Phone, City, State, Full Address, Category Label, and BBB Profile URL. get_business_profile adds Owner Name, Owner Email, Website URL, Business Type classification, and a ZIP+4 formatted ZIP Code — fields not present in the search results.Does the location filter in `search_businesses` strictly return businesses in that city?+
location parameter influences which regional BBB office's results are surfaced, but results may include businesses outside the exact city or ZIP code specified. Treat it as a regional proximity signal rather than a strict geographic filter.