Endpoint Playground
Browses bbb.org businesses by category and location directly, without a free-text search query. Returns the same business-result shape as bbb-search. 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. Optional sort and filter parameters use the same values as bbb-search; query-scoped category and state/province values come from bbb-search-filters.
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: “Team Flo-Right LLC” and 13 other values; url: bbb.org.
curl "https://api.crawlora.net/api/v1/bbb/category?url=https%3A%2F%2Fwww.bbb.org%2Fus%2Ftx%2Faustin%2Fcategory%2Fplumber&sort=Relevance&distance=5" \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| url | string | Yes | https://www.bbb.org/us/tx/austin/category/plumber | BBB category browse URL, from a bbb-search result's related_categories |
| page | integer | No | Result page, default 1 | |
| 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": {
"page": 1,
"total_results": 2398,
"results": [
{
"name": "Abundant Plumbing LLC",
"url": "https://www.bbb.org/us/tx/austin/profile/plumber/abundant-plumbing-llc-0825-1000237688",
"categories": [
"Plumber"
],
"rating": "A-",
"accredited": true,
"phone": "(512) 201-9978",
"address": "PO Box 40698, Austin, TX 78704-0012"
}
],
"source_url": "https://www.bbb.org/us/tx/austin/category/plumber"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.