Endpoint Playground
Returns the live sort, category, and state/province values BBB currently advertises for one context. Supply query and location for text search, or category_url for the exact category-browse context; do not combine these modes. Category IDs and state/province codes are query-scoped; call this endpoint again when the search context changes. Static accepted values are country USA or CAN; sort Relevance, Distance, Rating, AToZ, or ZToA; distance 5, 10, 25, 50, or 100 miles; rating A, B, C, D, or F.
14 Oct 2026: 3 states; 2 fields had a value in every checked item.
Sample value profiles: value: “MA” and 2 other values; label: “MA” and 2 other values.
curl "https://api.crawlora.net/api/v1/bbb/search/filters?country=USA&sort=Relevance&distance=5" \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| query | string | No | Business name or category/service keyword; use with location when category_url is omitted | |
| location | string | No | City and state/province or ZIP code; use with query when category_url is omitted | |
| category_url | string | No | BBB category browse URL; use instead of query and location | |
| country | string | No | USA | BBB country code |
| 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 | Selected rating values | |
| category_id | array | No | Selected category IDs previously returned for this search context | |
| state | array | No | Selected state/province codes previously returned for this search context | |
| 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",
"country": "USA",
"page": 1,
"total_results": 2544,
"sorts": [
{
"label": "Best Match",
"value": "Relevance",
"is_active": true
},
{
"label": "Distance",
"value": "Distance",
"is_active": false
},
{
"label": "Rating",
"value": "Rating",
"is_active": false
},
{
"label": "A-Z",
"value": "AToZ",
"is_active": false
},
{
"label": "Z-A",
"value": "ZToA",
"is_active": false
}
],
"categories": [
{
"value": "10113-000",
"label": "Plumber"
},
{
"value": "10113-100",
"label": "Commercial Plumber"
},
{
"value": "10113-300",
"label": "Plumbing Renovation"
},
{
"value": "10114-000",
"label": "Sewer Cleaning"
},
{
"value": "10167-000",
"label": "Water Heater Repair"
},
{
"value": "80781-010",
"label": "Water Heater Installation"
},
{
"value": "50720-100",
"label": "Tankless Water Heaters"
},
{
"value": "10043-010",
"label": "Drain Cleaning"
},
{
"value": "10131-000",
"label": "Sewer Contractors"
},
{
"value": "10113-010",
"label": "Plumbing and Heating"
}
],
"states": [
{
"value": "MA",
"label": "MA"
},
{
"value": "TX",
"label": "TX"
},
{
"value": "VA",
"label": "VA"
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.