datasets_bbb_scamtracker_reports_search
Search the BBB Scam Tracker reports dataset. 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…
Instructions
Search the BBB Scam Tracker reports dataset. 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.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Full-text match on the report narrative and the business name used, max 256 characters | |
| page | No | Page number, defaults to 1 | |
| sort | No | Sort enum: relevance, reported_desc, reported_asc, loss_desc | |
| state | No | 2-letter state or province code of the targeted person, e.g. TX or QC | |
| country | No | Country of the targeted person. Enum: USA, CAN | |
| date_to | No | Inclusive report-date ceiling, YYYY-MM-DD | |
| max_loss | No | Ceiling against the reported dollar loss, 0 or greater; reports with an unknown loss are excluded | |
| min_loss | No | Floor against the reported dollar loss, 0 or greater; reports with an unknown loss are excluded | |
| date_from | No | Inclusive report-date floor, YYYY-MM-DD | |
| page_size | No | Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000 | |
| scam_type | No | Exact scam type filter, e.g. Online Purchase. Use the values returned by facets?facet=scam_type |