Google Patents API endpoint
Returns a CPC classification symbol's official title, its position in the classification tree (parent/child symbols), related symbols, and its full scope-note description. Accepts a symbol at any level, e.g. a section ("A"), a class ("A61"), a subclass ("A61K"), or a full group/subgroup ("A61K31/00"). Public data, sourced from Google Patents' own search API.
/googlepatents/classificationQuery parameters:
code (required) — a CPC classification symbol, at any level of the scheme: a section (A), a class (A61), a subclass (A61K), or a full group/subgroup (A61K31/00).Response fields: code, name, relations[] (code, name, is_parent, is_child, is_related, description), description[] (the symbol's scope note, one paragraph per array entry), source_url, fetched_at.
An unknown or invalid CPC symbol returns a 404.
Example response (trimmed):
{"code":200,"msg":"OK","data":{"code":"A61K","name":"A61K - PREPARATIONS FOR MEDICAL, DENTAL OR TOILETRY PURPOSES","relations":[{"code":"A","name":"A - HUMAN NECESSITIES","is_parent":true},{"code":"A61","name":"A61 - MEDICAL OR VETERINARY SCIENCE; HYGIENE","is_parent":true},{"code":"A61K31/00","name":"A61K31/00 - Medicinal preparations containing organic active ingredients","is_child":true}],"description":["Compositions which are:","Used for medicinal purposes, e.g. drugs, biological compositions..."],"source_url":"https://patents.google.com/xhr/concept?context=wizard&id=A61K","fetched_at":"2026-08-15T20:00:00Z"}}
| Field | Filled in, of 41 checked | Values in the sample |
|---|---|---|
| code | 41 | |
| name | 41 | “A - HUMAN NECESSITIES” and 40 other values |
| is_parent | 2 | true in 2 of 2 |
| is_child | 22 | true in 22 of 22 |
| is_related | 17 | true in 17 of 17 |
| description | 17 | “Sex sterilants for invertebrates per se” and 16 other values |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| code | string | Yes | CPC classification symbol | A61K31/00 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/googlepatents/classification?code=A61K31%2F00" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"code": "A61K",
"name": "A61K - PREPARATIONS FOR MEDICAL, DENTAL OR TOILETRY PURPOSES",
"relations": [
{
"code": "A",
"name": "A - HUMAN NECESSITIES",
"is_parent": true
},
{
"code": "A61",
"name": "A61 - MEDICAL OR VETERINARY SCIENCE; HYGIENE",
"is_parent": true
},
{
"code": "A61K31/00",
"name": "A61K31/00 - Medicinal preparations containing organic active ingredients",
"is_child": true
}
],
"description": [
"Compositions which are:",
"Used for medicinal purposes, e.g. drugs, biological compositions..."
],
"source_url": "https://patents.google.com/xhr/concept?context=wizard&id=A61K",
"fetched_at": "2026-08-15T20:00:00Z"
}
}Request schema
No body schema
Response schema
#/definitions/googlepatents.classificationResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | googlepatents.ClassificationResponse | No | ||||
| data.code | string | No | A61K31/00 | |||
| data.description | array | No | ||||
| data.fetched_at | string | No | ||||
| data.name | string | No | A61K31/00 - Medicinal preparations containing organic active ingredients | |||
| data.relations | array | No | ||||
| data.relations[].code | string | No | A61 | |||
| data.relations[].description | string | No | ||||
| data.relations[].is_child | boolean | No | ||||
| data.relations[].is_parent | boolean | No | ||||
| data.relations[].is_related | boolean | No | ||||
| data.relations[].name | string | No | A61 - MEDICAL OR VETERINARY SCIENCE; HYGIENE | |||
| data.source_url | string | No | ||||
| 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/classification?code=A61K31%2F00" \
-H "x-api-key: $CRAWLORA_API_KEY"