Endpoint Playground
Searches bbb.org for businesses by name or category near a location. Returns each business's BBB rating letter grade, accreditation status, categories, service areas, contact info, and profile URL. A verified empty first page returns results: [] and total_results: 0; an unavailable or unrecognized page returns an error. A page beyond the exact last page returns 404, and a page beyond BBB's 15-page accessible limit returns 404 naming that limit. Category IDs and state/province codes are query-scoped; call bbb-search-filters to discover values for this query and location.
14 Oct 2026: 15 results; 8 fields had a value in every checked item and 3 varied between items.
Sample value profiles: rating: A+ (12), A (3); name: “Calixto Plumbing” and 13 other values; url: bbb.org.
curl "https://api.crawlora.net/api/v1/bbb/search?query=plumber&location=Austin%2C+TX&country=USA&sort=Relevance&distance=5" \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| query | string | Yes | plumber | Business name or category/service keyword |
| location | string | Yes | Austin, TX | City and state (e.g. 'Austin, TX') or a ZIP code |
| page | integer | No | Result page, default 1 | |
| country | string | No | USA | BBB country code |
| sort | string | No | Relevance | Sort order |
| distance | string | No | 5 | Maximum distance in miles; omit for all distances |
| rating | array | No | One or more BBB rating buckets | |
| category_id | array | No | Query-scoped category ID from bbb-search-filters | |
| state | array | No | Query-scoped state or province code from bbb-search-filters | |
| accredited | boolean | No | Only BBB-accredited businesses | |
| get_quote | boolean | No | Only businesses offering quote requests | |
| service_area | boolean | No | Only businesses serving the searched area |
{
"code": 200,
"msg": "OK",
"data": {
"query": "plumber",
"location": "Austin, TX",
"page": 1,
"total_results": 2544,
"results": [
{
"name": "Calixto Plumbing",
"url": "https://www.bbb.org/us/tx/austin/profile/plumber/calixto-plumbing-0825-1000223803",
"categories": [
"Plumber",
"Plumbing Renovation",
"Commercial Plumber",
"Plumbing and Heating"
],
"rating": "A+",
"accredited": true,
"phone": "(512) 945-3143",
"address": "8410 Georgian Dr # B, Austin, TX 78753-6003",
"image_url": "https://m.bbb.org/prod/ProfileImages/2024/1f7a8bd4-fdd2-45ca-8963-5c246e1d3b85.png",
"service_areas": [
"Bell County, TX",
"Travis County, TX"
],
"quote_url": "https://www.bbb.org/central-texas/quote/request-calixto-plumbing-1000223803"
}
],
"related_categories": [
{
"name": "Plumber",
"url": "https://www.bbb.org/us/tx/austin/category/plumber"
}
],
"source_url": "https://www.bbb.org/search?find_country=USA&find_loc=Austin%2C+TX&find_text=plumber"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.