Google Patents API endpoint
Returns a single patent's detail: title, abstract, inventors, assignees, dates, legal status, CPC/IPC classifications, claims, description, patent citations, cited-by patents, family members, and similar documents. `number` is a publication number such as `US10758101B2`, `EP1000000A1`, or `WO2020123456A1`. To search or browse by keyword, inventor, or assignee instead of a known publication number, use `/googlepatents/search`.
/googlepatents/detailQuery parameters:
number (required) — publication number, e.g. US10758101B2, EP1000000A1, WO2020123456A1.lang (optional, default en) — language code for the translated page. Not a fixed enum: Google Patents serves whichever machine-translation languages exist for a given document, a set that varies per patent.Response fields: publication_number, title, abstract, country_code, country_name, kind_code, application_number, priority_date, filing_date, publication_date, expiration_date, legal_status, inventors[], current_assignees[], original_assignees[], prior_art_keywords[], classifications[] (code, description, is_cpc), claims_count, claims[], description[] (paragraphs), citations[] and cited_by[] (publication_number, priority_date, publication_date, assignee, title), family_members[] (publication_number, publication_date), similar_documents[] (publication_number, publication_date, title), pdf_url, source_url, fetched_at.
An unknown or invalid publication number returns 404.
Example response (trimmed):
{"code":200,"msg":"OK","data":{"publication_number":"US10758101B2","title":"Upright vacuum cleaner with battery support plate","abstract":"Battery-powered upright vacuum cleaners are disclosed...","country_code":"US","country_name":"United States","kind_code":"B2","application_number":"US15/620,213","priority_date":"2017-06-12","filing_date":"2017-06-12","publication_date":"2020-09-01","expiration_date":"2038-04-26","legal_status":"Active","inventors":["Thomas E. Fogarty, Jr.","John L. Theising"],"current_assignees":["Emerson Electric Co"],"claims_count":19,"claims":["1. An upright vacuum cleaner comprising..."],"citations":[{"publication_number":"US4665582A","priority_date":"1985-02-22","publication_date":"1987-05-19","assignee":"National Union Electric Corp.","title":"Lightweight battery powered suction broom"}],"pdf_url":"https://patentimages.storage.googleapis.com/ae/9f/51/f34dc3bf93426e/US10758101.pdf","source_url":"https://patents.google.com/patent/US10758101B2/en","fetched_at":"2026-08-15T13:00:00Z"}}
| Field | Filled in, of 63 checked | Values in the sample |
|---|---|---|
| code | 63 | |
| description | 63 | “HUMAN NECESSITIES” and 24 other values |
| is_cpc | 63 | true in 63 of 63 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| number | string | Yes | Publication number, e.g. US10758101B2 | US10758101B2 | |
| lang | string | No | Language code for the translated page, default en | en | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/googlepatents/detail?number=US10758101B2&lang=en" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"publication_number": "US10758101B2",
"title": "Upright vacuum cleaner with battery support plate",
"abstract": "Battery-powered upright vacuum cleaners are disclosed...",
"country_code": "US",
"country_name": "United States",
"kind_code": "B2",
"application_number": "US15/620,213",
"priority_date": "2017-06-12",
"filing_date": "2017-06-12",
"publication_date": "2020-09-01",
"expiration_date": "2038-04-26",
"legal_status": "Active",
"inventors": [
"Thomas E. Fogarty, Jr.",
"John L. Theising"
],
"current_assignees": [
"Emerson Electric Co"
],
"claims_count": 19,
"claims": [
"1. An upright vacuum cleaner comprising..."
],
"citations": [
{
"publication_number": "US4665582A",
"priority_date": "1985-02-22",
"publication_date": "1987-05-19",
"assignee": "National Union Electric Corp.",
"title": "Lightweight battery powered suction broom"
}
],
"pdf_url": "https://patentimages.storage.googleapis.com/ae/9f/51/f34dc3bf93426e/US10758101.pdf",
"source_url": "https://patents.google.com/patent/US10758101B2/en",
"fetched_at": "2026-08-15T13:00:00Z"
}
}Request schema
No body schema
Response schema
#/definitions/googlepatents.detailResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | googlepatents.DetailResponse | No | ||||
| data.abstract | string | No | Battery-powered upright vacuum cleaners are disclosed. | |||
| data.application_number | string | No | US15/620,213 | |||
| data.citations | array | No | ||||
| data.citations[].assignee | string | No | Netzsch Maschinenfabrik | |||
| data.citations[].priority_date | string | No | 1985-12-27 | |||
| data.citations[].publication_date | string | No | 1987-05-19 | |||
| data.citations[].publication_number | string | No | US4665582A | |||
| data.citations[].title | string | No | Apparatus for shaking foundry moulds in a casting installation | |||
| data.cited_by | array | No | ||||
| data.cited_by[].assignee | string | No | Netzsch Maschinenfabrik | |||
| data.cited_by[].priority_date | string | No | 1985-12-27 | |||
| data.cited_by[].publication_date | string | No | 1987-05-19 | |||
| data.cited_by[].publication_number | string | No | US4665582A | |||
| data.cited_by[].title | string | No | Apparatus for shaking foundry moulds in a casting installation | |||
| data.claims | array | No | ||||
| data.claims_count | integer | No | 19 | |||
| data.classifications | array | No | ||||
| data.classifications[].code | string | No | A47L9/00 | |||
| data.classifications[].description | string | No | Details or accessories of suction cleaners | |||
| data.classifications[].is_cpc | boolean | No | true | |||
| data.country_code | string | No | US | |||
| data.country_name | string | No | United States | |||
| data.current_assignees | array | No | ||||
| data.description | array | No | ||||
| data.expiration_date | string | No | 2038-04-26 | |||
| data.family_members | array | No | ||||
| data.family_members[].publication_date | string | No | 2018-12-13 | |||
| data.family_members[].publication_number | string | No | US20180353038A1 | |||
| data.fetched_at | string | No | 2026-08-15T12:00:00Z | |||
| data.filing_date | string | No | 2017-06-12 | |||
| data.inventors | array | No | ||||
| data.kind_code | string | No | B2 | |||
| data.legal_status | string | No | Active | |||
| data.original_assignees | array | No | ||||
| data.pdf_url | string | No | https://patentimages.storage.googleapis.com/ae/9f/51/f34dc3bf93426e/US10758101.pdf | |||
| data.prior_art_keywords | array | No | ||||
| data.priority_date | string | No | 2017-06-12 | |||
| data.publication_date | string | No | 2020-09-01 | |||
| data.publication_number | string | No | US10758101B2 | |||
| data.similar_documents | array | No | ||||
| data.similar_documents[].publication_date | string | No | 1990-06-26 | |||
| data.similar_documents[].publication_number | string | No | CA1270625A | |||
| data.similar_documents[].title | string | No | Method and apparatus for setting pattern frame and press die | |||
| data.source_url | string | No | https://patents.google.com/patent/US10758101B2/en | |||
| data.title | string | No | Upright vacuum cleaner with battery support plate | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/googlepatents/detail?number=US10758101B2&lang=en" \
-H "x-api-key: $CRAWLORA_API_KEY"