Endpoint Playground
Returns a business's BBB complaint history: total complaint count, complaints closed or filed in the last 12 months, and one page of per-complaint detail (date, type, status, narrative text, and any business response / customer answer thread). Complaints are listed newest first, 10 per page; use page with the returned page, total_pages and has_more to walk the full list. A business with no filed complaints returns total_complaints 0 and an empty complaints list -- this is a normal result, not an error.
14 Oct 2026: Single record response; 7 fields had a value in every checked item; 1 field was empty in this sample.
Sample value profiles: total_complaints: 0; business_name: “Calixto Plumbing”; submit_complaint_url: bbb.org.
curl "https://api.crawlora.net/api/v1/bbb/business/complaints?url=https%3A%2F%2Fwww.bbb.org%2Fus%2Ftx%2Faustin%2Fprofile%2Fplumber%2Fcalixto-plumbing-0825-1000223803" \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| url | string | Yes | https://www.bbb.org/us/tx/austin/profile/plumber/calixto-plumbing-0825-1000223803 | BBB business profile URL, from a bbb-search result's url or hq_profile_url. A location URL ending in /addressId/<number> is accepted and read from the business profile |
| page | integer | No | Complaint list page, 1 or greater (10 complaints per page, newest first). Defaults to 1 |
{
"code": 200,
"msg": "OK",
"data": {
"business_name": "Abacus Plumbing, Air Conditioning & Electrical",
"total_complaints": 8,
"period_text": "in the last 3 years.",
"closed_last_12_months": 2,
"submit_complaint_url": "https://www.bbb.org/file-a-complaint/0825-1000193414",
"page": 1,
"total_pages": 1,
"has_more": false,
"complaints": [
{
"id": "0825_1000193414_24518957",
"date": "02/12/2026",
"type": "Service or Repair Issues",
"status": "Answered",
"text": "Abacus installed a Navien tankless water heater at my house...",
"business_responses": [
{
"date": "04/08/2026",
"text": "Dear Mr. REMOVED you for the opportunity to respond to your concerns..."
}
]
}
],
"source_url": "https://www.bbb.org/us/tx/austin/profile/plumbing-and-heating/abacus-plumbing-air-conditioning-electrical-0825-1000193414/complaints"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.