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.
Request
- Base URL: https://api.crawlora.net/api/v1
- URL: https://api.crawlora.net/api/v1/datasets/bbb-scamtracker-reports/search
- Auth: API key in header x-api-key
Query parameters
Full-text match on the report narrative and the business name used, max 256 characters
Exact scam type filter, e.g. Online Purchase. Use the values returned by facets?facet=scam_type
2-letter state or province code of the targeted person, e.g. TX or QC
Country of the targeted person. Enum: USA, CAN
Inclusive report-date floor, YYYY-MM-DD
Inclusive report-date ceiling, YYYY-MM-DD
Floor against the reported dollar loss, 0 or greater; reports with an unknown loss are excluded
Ceiling against the reported dollar loss, 0 or greater; reports with an unknown loss are excluded
Sort enum: relevance, reported_desc, reported_asc, loss_desc
Page number, defaults to 1
Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000
Headers
API key required
Response
OK
Example response
{
"code": 200,
"msg": "OK"
}Changes
No recorded changes to this operation across all 2 revisions of this API.