# USPTO Patent Grants — Weekly Grant Data API (`nexgendata/uspto-patent-grants`) Actor

Pull USPTO weekly patent-grant records in bulk. Clean JSON for IP counsel, brand teams and AI agents.

- **URL**: https://apify.com/nexgendata/uspto-patent-grants.md
- **Developed by:** [NexGenData](https://apify.com/nexgendata) (community)
- **Categories:** Business, AI
- **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $50.00 / 1,000 uspto patent records

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## USPTO Patent Grants

**Which grants actor?** This is the **bulk-data** one — full weekly USPTO patent-grant records, one row per grant. For scheduled new-grant alerts filtered to your watch, use the *USPTO Grants Tracker*. Pull USPTO weekly patent-grant records in bulk. Built for IP counsel, brand teams, researchers and AI agents.

### ⏰ Run this as a grant watch (recommended)

Every IP registry actor is a monitoring subscription, not a one-shot lookup. Schedule a weekly sweep and catch new filings as they land:

```json
{
  "query": "Apple Inc",
  "limit": 100
}
```

Weekly cron (`0 8 * * 1`) turns this into an always-on grant watch.

### 📊 What you get

Clean JSON, one record per patent (full output has 7 fields):

- `patent_number` — Patent number
- `title` — Title
- `assignee` — Assignee
- `grant_date` — Grant date
- `inventors` — Inventors
- `abstract` — Abstract
- `cpc_classes` — Cpc classes

**Pricing:** $0.10 per patent (Pay-Per-Event) — about **10 patents per $1**.

### 🤖 Use with AI agents

Point Claude, the OpenAI Agents SDK, an n8n flow or any MCP-aware client at it and run USPTO weekly patent-grant records on demand.

**Sample agent prompt:**

```
Pull this week's USPTO patent grants for an assignee as JSON.
```

**Agentic payments (x402):** Supports agentic payment via x402 — agents can call this actor with USDC, no API key required.

### 🔗 Related IP actors

**Prior-art & patent web:** [USPTO Patent Search](https://apify.com/nexgendata/uspto-patent-search), [USPTO Grants Tracker](https://apify.com/nexgendata/uspto-patent-grants-tracker), [WIPO PatentScope](https://apify.com/nexgendata/wipo-patentscope-search), [PatentsView Inventors](https://apify.com/nexgendata/patentsview-inventor-network-graph), [FDA Orange Book](https://apify.com/nexgendata/fda-orange-book-drug-patents)

**IP agent front door:** [Patents & Trademarks IP MCP](https://apify.com/nexgendata/patents-trademarks-ip-mcp-server)

***

*Data from public intellectual-property registries.*

# Actor input Schema

## `keywords` (type: `array`):

Free-text keywords to search across patent title + abstract. Each keyword becomes an OR clause. Examples: \['machine learning'], \['neural network', 'transformer'], \['CRISPR', 'gene editing'], \['battery', 'lithium-ion']. Leave empty to pull all newly granted patents in the date window (use date\_range + cpc\_class to narrow). Multi-word phrases are treated as exact phrases.

## `assignee_name` (type: `string`):

Restrict results to patents granted to a specific assignee (company / institution). Matches partial names, case-insensitive. Examples: 'Apple', 'Google', 'NVIDIA', 'IBM', 'MIT', 'Stanford'. Leave blank to include all assignees. Useful for competitive intelligence — monitor a specific competitor's filing cadence.

## `date_range` (type: `string`):

Filter by USPTO grant date (the date the patent was officially issued, not the application or priority date). 'today' = patents granted today only (USPTO publishes grants every Tuesday); 'week' = trailing 7 days; 'month' = trailing 30 days; 'year' = trailing 365 days; 'all' = no date filter (search the full Google Patents index).

## `cpc_class` (type: `string`):

Cooperative Patent Classification (CPC) symbol to filter by. Use either the 1-letter section (e.g. 'G' = Physics / G06 = Computing), the 4-character class (e.g. 'G06N' = AI/ML systems, 'H04L' = digital comms, 'A61K' = pharma compositions), or a full subgroup (e.g. 'G06N3/08' = neural-net learning methods). See cpc-tooltip below. Leave blank for any class.

## `ai_only` (type: `boolean`):

If true, return only patents flagged as AI / ML related. We mark a patent AI-related when its title or abstract contains terms like 'machine learning', 'neural network', 'deep learning', 'transformer', 'reinforcement learning', 'LLM', 'large language model', 'generative AI', 'natural language processing', 'computer vision', or when its CPC code is G06N (Computing arrangements based on specific computational models). Useful for AI VCs, AI M\&A diligence, and competitive intelligence on AI labs.

## `limit` (type: `integer`):

Maximum number of patent grant records to push to the dataset. The Google Patents result page returns up to 100 patents per page; we'll auto-paginate to satisfy your limit. Typical IP-monitoring workflows pull 50-500 records per refresh. For a full daily competitive-intel sweep set to 1000+.

## `enrich_details` (type: `boolean`):

If true, fetches each patent's detail page after the search to populate claims\_count, full CPC class list, citations\_count and a longer abstract excerpt. Doubles run time (one extra HTTP request per patent) but produces a far richer record. Recommended for IP / legal due-diligence workflows. If false, only fields available from the search-results JSON are emitted.

## Actor input object example

```json
{
  "keywords": [
    "machine learning"
  ],
  "assignee_name": "",
  "date_range": "month",
  "cpc_class": "",
  "ai_only": false,
  "limit": 50,
  "enrich_details": true
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "machine learning"
    ],
    "assignee_name": "",
    "date_range": "month",
    "cpc_class": "",
    "ai_only": false,
    "limit": 50,
    "enrich_details": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("nexgendata/uspto-patent-grants").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keywords": ["machine learning"],
    "assignee_name": "",
    "date_range": "month",
    "cpc_class": "",
    "ai_only": False,
    "limit": 50,
    "enrich_details": True,
}

# Run the Actor and wait for it to finish
run = client.actor("nexgendata/uspto-patent-grants").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "machine learning"
  ],
  "assignee_name": "",
  "date_range": "month",
  "cpc_class": "",
  "ai_only": false,
  "limit": 50,
  "enrich_details": true
}' |
apify call nexgendata/uspto-patent-grants --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=nexgendata/uspto-patent-grants",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/XowmqYSsyMUgBCA5Q/builds/sZP5cZutogfgMmeY6/openapi.json