BBB

Get a Better Business Bureau business's complaint history

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.

get/bbb/business/complaints

Request

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

Query parameters

urlstring required

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

pageinteger

Complaint list page, 1 or greater (10 complaints per page, newest first). Defaults to 1

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "closed_last_12_months": 2,
    "complaints": [
      {
        "status": "Resolved",
        "type": "Service or Repair Issues"
      }
    ],
    "filed_last_12_months": 3,
    "hidden_complaints": 408,
    "notice": "This profile is currently being updated. You will not be able to read any existing complaints at this time, but you may file a complaint.",
    "page": 1,
    "period_text": "in the last 3 years.",
    "published_complaints": 3778,
    "total_complaints": 8,
    "total_pages": 1
  },
  "msg": "OK"
}

Changes

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