Endpoint Playground
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.
14 Oct 2026: 64 states; 14 fields had a value in every checked item.
Sample value profiles: country: USA (51), CAN (13); reports: 1 to 5,008, median 524; name: “Alberta” and 63 other values.
curl "https://api.crawlora.net/api/v1/bbb/scamtracker/state-stats?period=30" \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| period | string | No | 30 | Aggregation window, default 90 |
{
"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
}
]
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.