# State Patent Metrics

> State Patent Metrics is a free dashboard and public read-only JSON API tracking USPTO patent grants by U.S. state. It covers patent grants since 2002 for tracked states (currently SD, ND, WY, IA, TX), with per-state totals, grant timelines, top applicants (assignees), top inventors, city breakdowns with coordinates, and CPC technology classifications. Data is sourced from the USPTO Open Data Portal and refreshes automatically every Tuesday at 10 AM US Central Time. Provided courtesy of Goodhue, Coleman & Owens, P.C. (https://www.goodhue.com).

A patent is counted for a state when any applicant or inventor on the patent has an address in that state. A patent can therefore count toward multiple states.

## API

The API is public, read-only, requires no authentication, and returns JSON. Rate limit: 100 requests/minute per IP.

- [API index](/api): machine-readable overview of the API, tracked states, and example requests
- [OpenAPI spec (JSON)](/api/openapi.json): full OpenAPI 3.1 specification
- [OpenAPI spec (YAML)](/api/openapi.yaml): same specification in YAML

### Key endpoints

- `GET /api/states` — all tracked states with headline stats (total patents, last-12-month count, top assignee, top city)
- `GET /api/states/{state}/summary` — headline metrics for one state (e.g. `/api/states/SD/summary`)
- `GET /api/states/{state}/timeline?granularity=yearly|monthly` — grant counts over time
- `GET /api/states/{state}/assignees?limit=10` — top patent applicants
- `GET /api/states/{state}/inventors?limit=10` — top inventors
- `GET /api/states/{state}/cities` — patent activity by city, with latitude/longitude
- `GET /api/states/{state}/classifications` — CPC technology-area breakdown
- `GET /api/states/{state}/recent-patents` — most recently granted patents

Most endpoints accept optional `fromYear` and `toYear` query parameters (calendar-year filters, e.g. `?fromYear=2023`).

`{state}` is a two-letter USPS state code from the tracked set (see `/api` for the current list).

## Dashboard

- [Dashboard](/): interactive dashboard; append a state code to the path to preselect it (e.g. `/SD`, `/ND`, `/WY`, `/IA`)

## Notes

- Coverage: U.S. patent grants from 2002 to present; updated weekly.
- Patent types: utility, design, plant, and reissue patents are included.
- Attribution: data from the USPTO Open Data Portal; dashboard and API provided by Goodhue, Coleman & Owens, P.C.