Google Patents

Search Google Patents by keyword, inventor, assignee, and other filters

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.

get/googlepatents/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/googlepatents/search
  • Auth: API key in header x-api-key

Query parameters

qstring required

Free-text search query

inventorstring

Filter by inventor name

assigneestring

Filter by assignee/applicant name

countrystring

Filter by patent office/authority code, e.g. US, EP, WO, CN, JP

status'GRANT' | 'APPLICATION'

Filter by legal status. Allowed values: GRANT, APPLICATION

type'PATENT' | 'DESIGN'

Filter by document type. Allowed values: PATENT, DESIGN

language'ENGLISH' | 'GERMAN' | 'CHINESE' | 'FRENCH' | 'SPANISH' | 'ARABIC' | 'JAPANESE' | 'KOREAN' | 'PORTUGUESE' | 'RUSSIAN' | 'ITALIAN' | 'DUTCH' | 'SWEDISH' | 'FINNISH' | 'NORWEGIAN' | 'DANISH'

Filter by document language. Allowed values: ENGLISH, GERMAN, CHINESE, FRENCH, SPANISH, ARABIC, JAPANESE, KOREAN, PORTUGUESE, RUSSIAN, ITALIAN, DUTCH, SWEDISH, FINNISH, NORWEGIAN, DANISH

date_field'priority' | 'filing' | 'publication'

Which date before/after filter. Allowed values: priority, filing, publication. Defaults to priority when before/after is set

beforestring

Only results dated on or before this date (YYYY-MM-DD)

afterstring

Only results dated on or after this date (YYYY-MM-DD)

sort'relevance' | 'new' | 'old'

Sort order. Allowed values: relevance, new, old. Defaults to relevance

numinteger

Results per page, default 10, max 100

pageinteger

Page number, 0-indexed, default 0

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "query": "battery",
    "results": [
      {
        "assignee": "Emerson Electric Co",
        "country_status": [
          {
            "country_code": "US",
            "state": "ACTIVE"
          }
        ],
        "detail_url": "https://patents.google.com/patent/US10758101B2/en",
        "filing_date": "2017-06-12",
        "grant_date": "2020-09-01",
        "inventor": "Thomas E. Fogarty, Jr.",
        "language": "en",
        "priority_date": "2017-06-12",
        "publication_date": "2020-09-01",
        "publication_number": "US10758101B2",
        "snippet": "a battery support plate adapted to support a battery...",
        "title": "Upright vacuum cleaner with battery support plate"
      }
    ],
    "top_assignees": [
      {
        "key": "Emerson Electric Co.",
        "value": 666
      }
    ],
    "top_classifications": [
      {
        "key": "Emerson Electric Co.",
        "value": 666
      }
    ],
    "top_inventors": [
      {
        "key": "Emerson Electric Co.",
        "value": 666
      }
    ],
    "total_pages": 100,
    "total_results": 112795
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.