Endpoint Playground

Try the BBB Scam Reports Facets API

Returns distribution counts over the stored BBB Scam Tracker reports (dataset id enum value `bbb-scamtracker-reports`), honoring the same filters as search. Counts are of stored reports. Facet enum: `scam_type`, `state`, `country`. country enum: `USA`, `CAN`. Dataset Playground requests query indexed data and do not apply proxy routing.

What a live request returned

14 Oct 2026: 38 items; 2 fields had a value in every checked item.

Observed request: GET /datasets/bbb-scamtracker-reports/facets?facet=scam_type
Fields with a value in every checked item: value, count

Sample value profiles: count: 1 to 84,484, median 1,932.

Request: GET /datasets/bbb-scamtracker-reports/facets
Cost: 1 credit/request
Auth: apiKey

BBB Scam Reports Facets API documentation Datasets platform page Pricing

Prefilled cURL

curl "https://api.crawlora.net/api/v1/datasets/bbb-scamtracker-reports/facets?facet=scam_type&country=USA" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
facet	string	Yes	scam_type	Facet enum: scam_type, state, country
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
state	string	No		2-letter state or province code of the targeted person
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
max_loss	number	No		Ceiling against the reported dollar loss, 0 or greater

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "bbb-scamtracker-reports",
    "facet": "scam_type",
    "items": [
      {
        "value": "Online Purchase",
        "count": 41250
      },
      {
        "value": "Phishing",
        "count": 18733
      }
    ]
  }
}

More Datasets endpoints

List stored scraped datasets Facet the Airbnb markets dataset Get an Airbnb market from the dataset Airbnb market density near a coordinate Search the Airbnb markets dataset Facet Apple Podcasts shows dataset Get an Apple Podcasts show from dataset Search Apple Podcasts shows dataset Search the app-charts dataset Search the app-reviews dataset Search the apps-intelligence dataset Facet the BBB businesses dataset All 136 Datasets endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestdatasets.scamTrackerReportsFacetResponseDocDatasets

GET /datasets/bbb-scamtracker-reports/facets

Facet the BBB Scam Tracker reports dataset

Response behavior

- `facet=scam_type` returns the scam type values to use as the `scam_type` search/facet filter, with counts. - `facet=state` and `facet=country` count reports by the targeted person's state or province and country. Reports whose location names neither are not counted. - Counts are of stored reports, not BBB's own totals; the archive is not complete. - Use it with a `date_from`/`date_to` range to size that range before paging through search. - Returns an empty `items` array (not an error) when nothing matches. Example response (counts are illustrative): ```json { "code": 200, "msg": "OK", "data": { "dataset": "bbb-scamtracker-reports", "facet": "scam_type", "items": [ { "value": "Online Purchase", "count": 41250 }, { "value": "Phishing", "count": 18733 } ] } } ```

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

facet

requiredstring

Facet enum: scam_type, state, country · allowed: scam_type, state, country

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "bbb-scamtracker-reports",
    "facet": "scam_type",
    "items": [
      {
        "value": "Online Purchase",
        "count": 41250
      },
      {
        "value": "Phishing",
        "count": 18733
      }
    ]
  }
}

Endpoint Playground

Try the BBB Scam Reports Facets API

What a live request returned

14 Oct 2026: 38 items; 2 fields had a value in every checked item.

Observed request: GET /datasets/bbb-scamtracker-reports/facets?facet=scam_type
Fields with a value in every checked item: value, count

Sample value profiles: count: 1 to 84,484, median 1,932.

Request: GET /datasets/bbb-scamtracker-reports/facets
Cost: 1 credit/request
Auth: apiKey

BBB Scam Reports Facets API documentation Datasets platform page Pricing

Prefilled cURL

curl "https://api.crawlora.net/api/v1/datasets/bbb-scamtracker-reports/facets?facet=scam_type&country=USA" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
facet	string	Yes	scam_type	Facet enum: scam_type, state, country
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
state	string	No		2-letter state or province code of the targeted person
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
max_loss	number	No		Ceiling against the reported dollar loss, 0 or greater

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "bbb-scamtracker-reports",
    "facet": "scam_type",
    "items": [
      {
        "value": "Online Purchase",
        "count": 41250
      },
      {
        "value": "Phishing",
        "count": 18733
      }
    ]
  }
}

More Datasets endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestdatasets.scamTrackerReportsFacetResponseDocDatasets

GET /datasets/bbb-scamtracker-reports/facets

Facet the BBB Scam Tracker reports dataset

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

facet

requiredstring

Facet enum: scam_type, state, country · allowed: scam_type, state, country

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "bbb-scamtracker-reports",
    "facet": "scam_type",
    "items": [
      {
        "value": "Online Purchase",
        "count": 41250
      },
      {
        "value": "Phishing",
        "count": 18733
      }
    ]
  }
}