> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Patents API

> Patents from Google Patents with title, abstract, assignees, inventors, priority date and filing date. Search by keyword.

`POST /v1/data/google-patents/patents/run`

**Pricing:** $0.01 per patent ($10.50 per 1,000).

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**query** `string` *required*

Search Query.

**assignee** `string`

Assignee.

**dateFrom** `date`

Date From as a date (YYYY-MM-DD).

**dateTo** `date`

Date To as a date (YYYY-MM-DD).

**dateType** `string` (default: publication)

Date Type to use. Publication Date by default.

Allowed values: `priority` (Priority Date), `filing` (Filing Date), `publication` (Publication Date).

**country** `string`

Patent office to search, picked by name (stored as its two-letter office code). Leave empty to search every office. Example: United States (US), European Patent Office (EP), Japan (JP).

40 allowed values, for example `AR` (Argentina), `AU` (Australia), `AT` (Austria), `BE` (Belgium), `BR` (Brazil), `CA` (Canada), `CN` (China), `CZ` (Czech Republic), `DK` (Denmark), `EP` (European Patent Office). Fetch the full list with `GET /v1/data/google-patents/patents?expand=options`.

**status** `string` (default: ANY)

Status to use. Any by default.

Allowed values: `ANY` (Any), `GRANT` (Granted only), `APPLICATION` (Applications only).

**sortBy** `string` (default: relevance)

Sort By to use. Relevance by default.

Allowed values: `relevance` (Relevance), `new` (Newest first), `old` (Oldest first).

**maxResults** `integer` (default: 100)

How many patents to return in total. Defaults to 100; use 0 for all.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/google-patents/patents/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "query": "attention-based sequence transduction",
    "assignee": "Google",
    "maxResults": 5
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/google-patents/patents/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "query": "attention-based sequence transduction",
    "assignee": "Google",
    "maxResults": 5
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/google-patents/patents/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "query": "attention-based sequence transduction",
  "assignee": "Google",
  "maxResults": 5
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one patent, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `publicationNumber` | Publication Number | text |
| `title` | Title | text |
| `abstract` | Abstract | text |
| `assignees` | Assignees | array |
| `inventors` | Inventors | array |
| `priorityDate` | Priority Date | text |
| `filingDate` | Filing Date | text |
| `publicationDate` | Publication Date | text |
| `grantDate` | Grant Date | text |
| `status` | Status | text |
| `applicationNumber` | Application Number | text |
| `language` | Language | text |
| `cpcCodes` | Cpc Codes | array |
| `claimsCount` | Claims Count | number |
| `patentCitations` | Patent Citations | number |
| `nonPatentCitations` | Non Patent Citations | number |
| `citedBy` | Cited By | number |
| `figureCount` | Figure Count | number |
| `pdfUrl` | Pdf URL | url |
| `patentUrl` | Patent URL | url |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "google-patents/patents",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "patentCitations": null,
      "cpcCodes": [
        "G06N20/00",
        "G06N3/00"
      ],
      "figureCount": 4,
      "publicationDate": "2019-10-22",
      "applicationNumber": "US:16/021,971",
      "pdfUrl": "https://patentimages.storage.googleapis.com/05/e8/f1/cd8eed389b7687/US10452978.pdf",
      "nonPatentCitations": 35,
      "assignees": [
        "Google LLC"
      ],
      "language": "en",
      "status": "Active",
      "publicationNumber": "US10452978B2",
      "grantDate": "2019-10-22",
      "patentUrl": "https://patents.google.com/patent/US10452978B2/en",
      "priorityDate": "2017-05-23",
      "abstract": "Methods, systems, and apparatus, including computer programs encoded on a computer storage medium, for generating an output sequence from an input sequence. ...",
      "claimsCount": 30,
      "title": "Attention-based sequence transduction neural networks",
      "inventors": [
        "Noam M. Shazeer",
        "Aidan Nicholas Gomez"
      ],
      "filingDate": "2018-06-28",
      "citedBy": 71
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.