---
title: "Get Better Business Bureau Scam Tracker state/province aggregate stats"
method: GET
path: "/bbb/scamtracker/state-stats"
tags: ["BBB"]
---

# Get Better Business Bureau Scam Tracker state/province aggregate stats

`GET /bbb/scamtracker/state-stats`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/bbb/scamtracker/state-stats`
- Auth: API key in header `x-api-key`

Returns aggregate scam-report stats per US state and Canadian province for a given time window: report counts, dollar losses, per-capita rates, year-over-year change, and top scam-type breakdown.

## Query parameters

- `period` '30' | '90' | '365' | 'all'

## Headers

- `x-api-key` string, required

## Response `200`

OK

- BbbscamtrackerStateStatsResponseDoc
  - `code` integer
  - `data` BbbscamtrackerStateStatsResponse
    - `aggregated_at` string
    - `period` string
    - `states` BbbscamtrackerStateStat[]
      - `code` string
      - `country` string
      - `losses` integer
      - `losses_per_capita` number
      - `median_loss` integer
      - `name` string
      - `pct_reporting_loss` number
      - `population` integer
      - `reports` integer
      - `reports_per_capita` number
      - `reports_with_loss` integer
      - `scam_type_breakdown` BbbscamtrackerScamTypeShare[]
        - `count` integer
        - `pct` number
        - `type` string
      - `top_scam_type` string
      - `yoy_change_pct` number
  - `msg` string

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)