Endpoint Playground

Try the BBB Scam Tracker State Stats API

Test Crawlora's BBB Scam Tracker State Stats 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/scamtracker/state-stats
Platform: BBB
Auth: apiKey
Credits: 2 credits/request
Required params: None
Common optional params: period

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

Prefilled cURL

curl "https://api.crawlora.net/api/v1/bbb/scamtracker/state-stats?period=30" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
period	string	No	30	Aggregation window, default 90

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "period": "90",
    "aggregated_at": "2026-08-20T03:00:22.405Z",
    "states": [
      {
        "country": "USA",
        "code": "TX",
        "name": "Texas",
        "reports": 4085,
        "reports_with_loss": 1950,
        "pct_reporting_loss": 47.7,
        "losses": 3163720,
        "median_loss": 97,
        "population": 30503301,
        "reports_per_capita": 0.0001339199321411148,
        "losses_per_capita": 0.10371729931786727,
        "yoy_change_pct": -3.4,
        "top_scam_type": "Online Purchase",
        "scam_type_breakdown": [
          {
            "type": "Online Purchase",
            "count": 1177,
            "pct": 32.9
          },
          {
            "type": "Other",
            "count": 626,
            "pct": 17.5
          }
        ]
      }
    ]
  }
}

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/requestbbbscamtracker.stateStatsResponseDocBBB

GET /bbb/scamtracker/state-stats

Get Better Business Bureau Scam Tracker state/province aggregate stats

Returns aggregate scam-report stats per US state and Canadian province for a given time window: report counts, dollar losses, per-capita rates, year-over-year change, and top scam-type breakdown. This calls the same JSON API the BBB Scam Tracker heatmap dashboard's own frontend uses -- not an HTML scrape. 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

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": {
    "period": "90",
    "aggregated_at": "2026-08-20T03:00:22.405Z",
    "states": [
      {
        "country": "USA",
        "code": "TX",
        "name": "Texas",
        "reports": 4085,
        "reports_with_loss": 1950,
        "pct_reporting_loss": 47.7,
        "losses": 3163720,
        "median_loss": 97,
        "population": 30503301,
        "reports_per_capita": 0.0001339199321411148,
        "losses_per_capita": 0.10371729931786727,
        "yoy_change_pct": -3.4,
        "top_scam_type": "Online Purchase",
        "scam_type_breakdown": [
          {
            "type": "Online Purchase",
            "count": 1177,
            "pct": 32.9
          },
          {
            "type": "Other",
            "count": 626,
            "pct": 17.5
          }
        ]
      }
    ]
  }
}

Endpoint details

Method: GET
Path: /bbb/scamtracker/state-stats
Authentication: apiKey
Credit cost: 2 credits/request
Platform: BBB
Parameters: 2 documented fields

Request parameters

period:queryx-api-key:header

Response schema fields

codedatadata.aggregated_atdata.perioddata.statesdata.states[].codedata.states[].countrydata.states[].lossesdata.states[].losses_per_capitadata.states[].median_lossdata.states[].namedata.states[].pct_reporting_loss

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "period": "90",
    "aggregated_at": "2026-08-20T03:00:22.405Z",
    "states": [
      {
        "country": "USA",
        "code": "TX",
        "name": "Texas",
        "reports": 4085,
        "reports_with_loss": 1950,
        "pct_reporting_loss": 47.7,
        "losses": 3163720,
        "median_loss": 97,
        "population": 30503301,
        "reports_per_capita": 0.0001339199321411148,
        "losses_per_capita": 0.10371729931786727,
        "yoy_change_pct": -3.4,
        "top_scam_type": "Online Purchase",
        "scam_type_breakdown": [
          {
            "type": "Online Purchase",
            "count": 1177,
            "pct": 32.9
          },
          {
            "type": "Other",
            "count": 626,
            "pct": 17.5
          }
        ]
      }
    ]
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/bbb/scamtracker/state-stats" \
  -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 complaint history 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

Endpoint Playground

Try the BBB Scam Tracker State Stats API

Endpoint facts

Method: GET
API path: /bbb/scamtracker/state-stats
Platform: BBB
Auth: apiKey
Credits: 2 credits/request
Required params: None
Common optional params: period

Prefilled cURL

curl "https://api.crawlora.net/api/v1/bbb/scamtracker/state-stats?period=30" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
period	string	No	30	Aggregation window, default 90

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "period": "90",
    "aggregated_at": "2026-08-20T03:00:22.405Z",
    "states": [
      {
        "country": "USA",
        "code": "TX",
        "name": "Texas",
        "reports": 4085,
        "reports_with_loss": 1950,
        "pct_reporting_loss": 47.7,
        "losses": 3163720,
        "median_loss": 97,
        "population": 30503301,
        "reports_per_capita": 0.0001339199321411148,
        "losses_per_capita": 0.10371729931786727,
        "yoy_change_pct": -3.4,
        "top_scam_type": "Online Purchase",
        "scam_type_breakdown": [
          {
            "type": "Online Purchase",
            "count": 1177,
            "pct": 32.9
          },
          {
            "type": "Other",
            "count": 626,
            "pct": 17.5
          }
        ]
      }
    ]
  }
}

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/requestbbbscamtracker.stateStatsResponseDocBBB

GET /bbb/scamtracker/state-stats

Get Better Business Bureau Scam Tracker state/province aggregate stats

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

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": {
    "period": "90",
    "aggregated_at": "2026-08-20T03:00:22.405Z",
    "states": [
      {
        "country": "USA",
        "code": "TX",
        "name": "Texas",
        "reports": 4085,
        "reports_with_loss": 1950,
        "pct_reporting_loss": 47.7,
        "losses": 3163720,
        "median_loss": 97,
        "population": 30503301,
        "reports_per_capita": 0.0001339199321411148,
        "losses_per_capita": 0.10371729931786727,
        "yoy_change_pct": -3.4,
        "top_scam_type": "Online Purchase",
        "scam_type_breakdown": [
          {
            "type": "Online Purchase",
            "count": 1177,
            "pct": 32.9
          },
          {
            "type": "Other",
            "count": 626,
            "pct": 17.5
          }
        ]
      }
    ]
  }
}

Endpoint details

Method: GET
Path: /bbb/scamtracker/state-stats
Authentication: apiKey
Credit cost: 2 credits/request
Platform: BBB
Parameters: 2 documented fields

Request parameters

period:queryx-api-key:header

Response schema fields

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "period": "90",
    "aggregated_at": "2026-08-20T03:00:22.405Z",
    "states": [
      {
        "country": "USA",
        "code": "TX",
        "name": "Texas",
        "reports": 4085,
        "reports_with_loss": 1950,
        "pct_reporting_loss": 47.7,
        "losses": 3163720,
        "median_loss": 97,
        "population": 30503301,
        "reports_per_capita": 0.0001339199321411148,
        "losses_per_capita": 0.10371729931786727,
        "yoy_change_pct": -3.4,
        "top_scam_type": "Online Purchase",
        "scam_type_breakdown": [
          {
            "type": "Online Purchase",
            "count": 1177,
            "pct": 32.9
          },
          {
            "type": "Other",
            "count": 626,
            "pct": 17.5
          }
        ]
      }
    ]
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/bbb/scamtracker/state-stats" \
  -H "x-api-key: $CRAWLORA_API_KEY"