Endpoint Playground
Test Crawlora's Patents Search API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.
curl "https://api.crawlora.net/api/v1/googlepatents/search?q=<q>&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 | 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"
}
}Public Playground
Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.
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 normalized hits plus top-assignee/top-inventor/top-classification breakdowns over the full result set. Public data, sourced from Google Patents' own search API.
{
"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"
}
}curl "https://api.crawlora.net/api/v1/googlepatents/search?q=<q>" \
-H "x-api-key: $CRAWLORA_API_KEY"