Endpoint Playground

Try the BBB Business Complaints API

Test Crawlora's BBB Business Complaints API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.

Endpoint facts

Method: GET
API path: /bbb/business/complaints
Platform: BBB
Auth: apiKey
Credits: 2 credits/request
Required params: url

BBB Business Complaints API documentation BBB platform page Crawlora API pricing Try BBB Business API Try BBB Business More Info API Try BBB Business Reviews API Try BBB Category API Try BBB Scam Tracker Detail API

Prefilled cURL

curl "https://api.crawlora.net/api/v1/bbb/business/complaints?url=<url>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
url	string	Yes		BBB business profile URL, from a bbb-search result's url or hq_profile_url

Example JSON response

{
  "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",
    "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"
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey2 credits/requestbbb.complaintsResponseDocBBB

GET /bbb/business/complaints

Get a Better Business Bureau business's complaint history

Returns a business's BBB complaint history: total complaint count, complaints closed in the last 12 months, and per-complaint detail (date, type, status, narrative text, and any business response / customer answer thread). A business with no filed complaints returns total_complaints 0 and an empty complaints list -- this is a normal result, not an error. Credential-free public Better Business Bureau data.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

url

requiredstring

BBB business profile URL, from a bbb-search result's url or hq_profile_url

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "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",
    "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"
  }
}

Endpoint details

Method: GET
Path: /bbb/business/complaints
Authentication: apiKey
Credit cost: 2 credits/request
Platform: BBB
Parameters: 2 documented fields

Request parameters

url:queryx-api-key:header

Response schema fields

codedatadata.business_namedata.closed_last_12_monthsdata.complaintsdata.complaints[].business_responsesdata.complaints[].business_responses[].datedata.complaints[].business_responses[].textdata.complaints[].customer_answersdata.complaints[].customer_answers[].datedata.complaints[].customer_answers[].textdata.complaints[].date

Sample response summary

{
  "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",
    "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"
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/bbb/business/complaints?url=<url>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

View endpoint docs Open platform page Browse all endpoints Pricing Get a Better Business Bureau business profile Get a Better Business Bureau business's full rating reasons and service area Get a Better Business Bureau business's customer reviews Browse a Better Business Bureau category Get a Better Business Bureau Scam Tracker report

Endpoint Playground

Try the BBB Business Complaints API

Endpoint facts

Method: GET
API path: /bbb/business/complaints
Platform: BBB
Auth: apiKey
Credits: 2 credits/request
Required params: url

Prefilled cURL

curl "https://api.crawlora.net/api/v1/bbb/business/complaints?url=<url>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
url	string	Yes		BBB business profile URL, from a bbb-search result's url or hq_profile_url

Example JSON response

{
  "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",
    "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"
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey2 credits/requestbbb.complaintsResponseDocBBB

GET /bbb/business/complaints

Get a Better Business Bureau business's complaint history

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

url

requiredstring

BBB business profile URL, from a bbb-search result's url or hq_profile_url

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "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",
    "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"
  }
}

Endpoint details

Method: GET
Path: /bbb/business/complaints
Authentication: apiKey
Credit cost: 2 credits/request
Platform: BBB
Parameters: 2 documented fields

Request parameters

url:queryx-api-key:header

Response schema fields

Sample response summary

{
  "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",
    "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"
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/bbb/business/complaints?url=<url>" \
  -H "x-api-key: $CRAWLORA_API_KEY"