BBB

Search Better Business Bureau businesses

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.

get/bbb/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/bbb/search
  • Auth: API key in header x-api-key

Query parameters

querystring required

Business name or category/service keyword

locationstring required

City and state (e.g. 'Austin, TX') or a ZIP code

pageinteger

Result page, default 1

country'USA' | 'CAN'

BBB country code

sort'Relevance' | 'Distance' | 'Rating' | 'AToZ' | 'ZToA'

Sort order

distance'5' | '10' | '25' | '50' | '100'

Maximum distance in miles; omit for all distances

ratingstring[]

One or more BBB rating buckets

category_idstring[]

Query-scoped category ID from bbb-search-filters

statestring[]

Query-scoped state or province code from bbb-search-filters

accreditedboolean

Only BBB-accredited businesses

get_quoteboolean

Only businesses offering quote requests

service_areaboolean

Only businesses serving the searched area

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "has_more": true,
    "location": "Austin, TX",
    "page": 1,
    "query": "plumber",
    "related_categories": [
      {
        "name": "Plumber"
      }
    ],
    "results": [
      {
        "rating": "A+"
      }
    ],
    "results_capped": true,
    "total_pages": 15,
    "total_results": 2514
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 3 revisions of this API.