bbb_scamtracker_search
Search Better Business Bureau Scam Tracker reports by free-text query, scam category, state, date range, or dollar loss to find consumer-reported scam incidents.
Instructions
Search Better Business Bureau Scam Tracker reports. Searches bbb.org Scam Tracker's consumer-reported-scam database by free-text query, scam category, targeted-victim state/province, reported-scammer state/province, report-date range, and/or dollar-loss range, paginated 10 results/page. A verified search with no matches returns results: [] and total_results: 0; an unavailable or unrecognized page returns 503 rather than an empty list. When result cards are present but BBB's total count is unavailable, total_results is omitted. Every page returns has_more and, when BBB's result count is exact, total_pages: request the next page only while has_more is true, because a page past the end returns 404. Omit every filter to browse the most-recent-first feed. This is a separate BBB dataset from the bbb-search/bbb-business/bbb-business-complaints business-rating family -- consumer-reported scam incidents, not business ratings.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Result page (10 per page), default 1 | |
| query | No | Free-text search (phone number, website, email, business name, scam ID, description). Omit to browse the most-recent feed | |
| state | No | Optional 2-letter targeted-victim state/province code (US state or Canadian province) | |
| date_to | No | Optional report-date range end (YYYY-MM-DD), inclusive. Must be set together with date_from | |
| date_from | No | Optional report-date range start (YYYY-MM-DD), inclusive. Must be set together with date_to | |
| scam_type | No | Scam category filter | |
| scammer_state | No | Optional 2-letter reported-scammer state/province code (US state or Canadian province) -- where the scammer is reported to be, not the victim | |
| max_dollars_lost | No | Optional maximum reported dollar loss. Must be set together with min_dollars_lost | |
| min_dollars_lost | No | Optional minimum reported dollar loss. Must be set together with max_dollars_lost |