Endpoint Playground
Searches Google Patents' full index by free-text query, with optional inventor, assignee, patent office, status, type, language, and date filters. Returns a page of hits plus top-assignee/top-inventor/top-classification breakdowns over the full result set.
14 Oct 2026: 10 results; 14 fields had a value in every checked item and 1 varied between items.
Sample value profiles: priority_date: 2010-04-26 to 2021-07-26; publication_number: “CN113650574B” and 9 other values; thumbnail_url: patentimages.storage.googleapis.com.
curl 'https://api.crawlora.net/api/v1/googlepatents/search?q=battery&status=GRANT&type=PATENT&language=ENGLISH&date_field=priority&sort=relevance' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | Yes | battery | Free-text search query |
| inventor | string | No | Filter by inventor name | |
| assignee | string | No | Filter by assignee/applicant name | |
| country | string | No | Filter by patent office/authority code, e.g. US, EP, WO, CN, JP | |
| status | string | No | GRANT | Filter by legal status. Allowed values: GRANT, APPLICATION |
| type | string | No | PATENT | Filter by document type. Allowed values: PATENT, DESIGN |
| language | string | No | ENGLISH | Filter by document language. Allowed values: ENGLISH, GERMAN, CHINESE, FRENCH, SPANISH, ARABIC, JAPANESE, KOREAN, PORTUGUESE, RUSSIAN, ITALIAN, DUTCH, SWEDISH, FINNISH, NORWEGIAN, DANISH |
| date_field | string | No | priority | Which date before/after filter. Allowed values: priority, filing, publication. Defaults to priority when before/after is set |
| before | string | No | Only results dated on or before this date (YYYY-MM-DD) | |
| after | string | No | Only results dated on or after this date (YYYY-MM-DD) | |
| sort | string | No | relevance | Sort order. Allowed values: relevance, new, old. Defaults to relevance |
| num | integer | No | Results per page, default 10, max 100 | |
| page | integer | No | Page number, 0-indexed, default 0 |
{
"code": 200,
"msg": "OK",
"data": {
"query": "battery",
"total_results": 112795,
"total_pages": 100,
"page": 0,
"results": [
{
"publication_number": "US10758101B2",
"title": "Upright vacuum cleaner with battery support plate",
"snippet": "a battery support plate adapted to support a battery...",
"priority_date": "2017-06-12",
"publication_date": "2020-09-01",
"inventor": "Thomas E. Fogarty, Jr.",
"assignee": "Emerson Electric Co",
"language": "en",
"pdf_url": "https://patentimages.storage.googleapis.com/ae/9f/51/f34dc3bf93426e/US10758101.pdf",
"detail_url": "https://patents.google.com/patent/US10758101B2/en",
"country_status": [
{
"country_code": "US",
"state": "ACTIVE"
}
]
}
],
"top_assignees": [
{
"key": "Emerson Electric Co.",
"value": 666
}
],
"source_url": "https://patents.google.com/xhr/query?url=q%3Dbattery%26num%3D10&exp=",
"fetched_at": "2026-08-15T14:00:00Z"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.