Skip to main content
POST
/
api
/
bbb
/
businesses
/
search
/bbb/businesses/search
curl --request POST \
  --url https://api.anysite.io/api/bbb/businesses/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "keyword": "<string>",
  "count": 2,
  "timeout": 300,
  "location": "",
  "accredited_only": false
}
'
[
  {
    "@type": "@bbb_business_search_result",
    "id": "<string>",
    "name": "<string>",
    "image": "<string>",
    "bbb_rating": "<string>",
    "is_accredited": true,
    "phone": "<string>",
    "category": "<string>",
    "categories": [],
    "address": "<string>",
    "city": "<string>",
    "state": "<string>",
    "zip_code": "<string>",
    "rating_score": 123,
    "bbb_name": "<string>",
    "profile_url": "<string>",
    "local_profile_url": "<string>"
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
keyword
string
required

Business name or category to search for

Minimum string length: 1
Example:

"plumbing"

count
integer
required

Max number of results to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
location
string
default:""

City and state or ZIP code to search near

Example:

"New York, NY"

rating
enum<string> | null

Only return businesses with this BBB rating

Available options:
A,
B,
C,
D,
F
accredited_only
boolean
default:false

Only return BBB accredited businesses

radius
enum<string> | null

Search radius in miles around the location

Available options:
5,
10,
25,
50,
100

Response

Successful Response

@type
string
default:@bbb_business_search_result
id
string | null
name
string | null
image
string | null
bbb_rating
string | null
is_accredited
boolean | null
phone
string | null
category
string | null
categories
string[]
address
string | null
city
string | null
state
string | null
zip_code
string | null
rating_score
number | null
bbb_name
string | null
profile_url
string | null
local_profile_url
string | null