Datasets

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.

get/datasets/bbb-scamtracker-reports/search

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

qstring

Full-text match on the report narrative and the business name used, max 256 characters

scam_typestring

Exact scam type filter, e.g. Online Purchase. Use the values returned by facets?facet=scam_type

statestring

2-letter state or province code of the targeted person, e.g. TX or QC

country'USA' | 'CAN'

Country of the targeted person. Enum: USA, CAN

date_fromstring

Inclusive report-date floor, YYYY-MM-DD

date_tostring

Inclusive report-date ceiling, YYYY-MM-DD

min_lossnumber

Floor against the reported dollar loss, 0 or greater; reports with an unknown loss are excluded

max_lossnumber

Ceiling against the reported dollar loss, 0 or greater; reports with an unknown loss are excluded

sort'relevance' | 'reported_desc' | 'reported_asc' | 'loss_desc'

Sort enum: relevance, reported_desc, reported_asc, loss_desc

pageinteger

Page number, defaults to 1

page_sizeinteger

Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.