Endpoint Playground
Searches the stored archive of public consumer scam reports from bbb.org/scamtracker (dataset id enum value `bbb-scamtracker-reports`), one record per report: narrative, scam type, reported dollar loss, targeted and scammer locations, the business name used, and the report date. Unlike the live bbb-scamtracker-search endpoint, results are not cut off at BBB's 10,000-result limit and any date range can be read page by page. Reports are unreviewed consumer allegations; names and contact details in them are as reported, not verified. The archive is still being filled, so `total` is the number of stored reports matching the filters, not BBB's own count. country enum: `USA`, `CAN`. sort enum: `relevance`, `reported_desc`, `reported_asc`, `loss_desc`. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100); the item and facets endpoints cost 1. Dataset Playground requests query indexed data and do not apply proxy routing.
14 Oct 2026: 20 items; 17 fields had a value in every checked item and 2 varied between items.
Sample value profiles: reported_at: 2026-10-12; loss_amount: 22 to 2,500, median 70; source_url: bbb.org.
curl "https://api.crawlora.net/api/v1/datasets/bbb-scamtracker-reports/search?country=USA&sort=relevance" \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | No | Full-text match on the report narrative and the business name used, max 256 characters | |
| scam_type | string | No | Exact scam type filter, e.g. Online Purchase. Use the values returned by facets?facet=scam_type | |
| state | string | No | 2-letter state or province code of the targeted person, e.g. TX or QC | |
| country | string | No | USA | Country of the targeted person. Enum: USA, CAN |
| date_from | string | No | Inclusive report-date floor, YYYY-MM-DD | |
| date_to | string | No | Inclusive report-date ceiling, YYYY-MM-DD | |
| min_loss | number | No | Floor against the reported dollar loss, 0 or greater; reports with an unknown loss are excluded | |
| max_loss | number | No | Ceiling against the reported dollar loss, 0 or greater; reports with an unknown loss are excluded | |
| sort | string | No | relevance | Sort enum: relevance, reported_desc, reported_asc, loss_desc |
| page | integer | No | Page number, defaults to 1 | |
| page_size | integer | No | Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000 |
{
"code": 200,
"msg": "OK",
"data": {
"dataset": "bbb-scamtracker-reports",
"items": [
{
"report_id": "1397968",
"description": "AltRX has taken $149 and is stringing me along about my 2nd delivery. They deducted money from my account with no product being delivered",
"dollars_lost": "$149",
"loss_amount": 149,
"targeted_location": "Chesapeake, VA, USA - 23322",
"country": "USA",
"state": "VA",
"scammer_location": "GA",
"scammer_email": "Unknown Email",
"scammer_phone": "Unknown Phone Number",
"scammer_url": "Unknown URL",
"scam_type": "Online Purchase",
"business_name": "AltRX",
"date_reported": "August 19, 2026",
"reported_at": "2026-08-19T00:00:00Z",
"source_url": "https://www.bbb.org/scamtracker/lookupscam/1397968",
"discovery_source": "search",
"crawled_at": "2026-10-09T04:12:31Z",
"schema_version": 1
}
],
"page": 1,
"page_size": 20,
"total": 1,
"sort": "reported_desc"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.