# govparse.io Patent Grants Bulk Feed

> govparse.io Patent Grants Bulk Feed is a paid API for AI agents from api.govparse.io, paid per call via x402, $25/call, status unknown (last checked 2026-09-15).

Returns a cursor-paginated bulk feed of USPTO patent assignees ranked by grant count, filterable by state, CPC subclass, minimum grants, and first-time assignees.

## Facts

- Endpoint: GET https://api.govparse.io/v1/feeds/patent-grants
- Price: $25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/govparse-io-patent-grants-bulk-feed-ce71d058
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HFMeu9j_YSazaJA-bWyZt

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability govparse-io-patent-grants-bulk-feed-ce71d058
```

Example prompt: Give me the top patent assignees in AI and machine learning — CPC subclass G06N — since 2024-01-01, with at least 10 grants, limited to California companies, and flag any that are first-time assignees.

## When to prefer this

Choose this endpoint when you need bulk, ranked patent assignee data from the USPTO with flexible filtering by technology area (CPC), geography, recency, or novelty (first-time assignees). It is ideal for competitive intelligence, R&D signal detection, and market research workflows that require more than a single-entity lookup — particularly when you need cursor-paginated access to thousands of records. Prefer alternatives if you need full patent text, claim details, or citation graphs rather than assignee-level aggregates.

## Known failure modes

- Invalid CPC subclass string returns empty results or 400 error
- Invalid cursor token causes pagination error or 400
- min_grants set too high returns empty result set
- since date in wrong format (not YYYY-MM-DD) returns 400
- limit exceeding 1000 is capped or rejected
- State code typo yields no results silently
- $25 USDC payment failure via x402 blocks access entirely

## How this service works

Which companies are granting a cluster of patents? Bulk feed over USPTO / PatentsView granted-patent assignees, ordered by grant count in the loaded window — an assignee with a cluster of grants is an R&D/growth signal. Cursor-paginated up to 1000/page, filterable by state, minimum grants, CPC subclass, first-time-assignee only, or since. Rows carry the assignee, grant count, CPC tech areas, grant window, inventor count, and a first_time_assignee flag. CC BY 4.0 attribution (in _meta.notice).

## Output

A paginated list of patent assignee rows, each containing the assignee name, total grant count in the loaded window, CPC technology area tags, grant window dates, inventor count, and a boolean first_time_assignee flag. Includes a next_cursor for fetching additional pages and a _meta.notice field with CC BY 4.0 attribution text.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [],
   "properties": {
    "cpc": {
     "type": "string",
     "examples": [
      "G06N"
     ],
     "description": "CPC subclass(es), CSV — the technology area. Example: G06N (AI/ML)."
    },
    "limit": {
     "type": "integer",
     "examples": [
      500
     ],
     "description": "Rows per page (default 500, cap 1000)."
    },
    "since": {
     "type": "string",
     "examples": [
      "2024-01-01"
     ],
     "description": "Only assignees whose latest grant is on or after this date (YYYY-MM-DD)."
    },
    "state": {
     "type": "string",
     "examples": [
      "CA"
     ],
     "description": "Assignee state code(s), CSV."
    },
    "cursor": {
     "type": "string",
     "examples": [
      "eyJjIjozMjIyLCJrIjoiYXNzaWduZWU6MTIzIn0"
     ],
     "description": "Opaque page cursor — pass the previous page's next_cursor unchanged."
    },
    "new_only": {
     "type": "string",
     "examples": [
      "true"
     ],
     "description": "true = only first-time (newly-observed) assignees granting in this window."
    },
    "min_grants": {
     "type": "integer",
     "examples": [
      10
     ],
     "description": "Minimum grant count in the window."
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/govparse-io-patent-grants-bulk-feed-ce71d058/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.govparse.io](https://www.zero.xyz/host/api.govparse.io/llms.txt)