---
title: "Search Google Patents by keyword, inventor, assignee, and other filters"
method: GET
path: "/googlepatents/search"
tags: ["Google Patents"]
---

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

`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`

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.

## Query parameters

- `q` string, required
- `inventor` string
- `assignee` string
- `country` string
- `status` 'GRANT' | 'APPLICATION'
- `type` 'PATENT' | 'DESIGN'
- `language` 'ENGLISH' | 'GERMAN' | 'CHINESE' | 'FRENCH' | 'SPANISH' | 'ARABIC' | 'JAPANESE' | 'KOREAN' | 'PORTUGUESE' | 'RUSSIAN' | 'ITALIAN' | 'DUTCH' | 'SWEDISH' | 'FINNISH' | 'NORWEGIAN' | 'DANISH'
- `date_field` 'priority' | 'filing' | 'publication'
- `before` string
- `after` string
- `sort` 'relevance' | 'new' | 'old'
- `num` integer
- `page` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- GooglepatentsSearchResponseDoc
  - `code` integer
  - `data` GooglepatentsSearchResponse
    - `fetched_at` string
    - `many_results` boolean
    - `page` integer
    - `query` string
    - `results` GooglepatentsSearchResult[]
      - `assignee` string
      - `country_status` GooglepatentsCountryStatus[]
        - `country_code` string
        - `state` string
      - `detail_url` string
      - `filing_date` string
      - `grant_date` string
      - `inventor` string
      - `is_similar_document` boolean
      - `language` string
      - `pdf_url` string
      - `priority_date` string
      - `publication_date` string
      - `publication_number` string
      - `snippet` string
      - `thumbnail_url` string
      - `title` string
    - `source_url` string
    - `top_assignees` GooglepatentsFacetEntry[]
      - `key` string
      - `value` integer
    - `top_classifications` GooglepatentsFacetEntry[]
      - `key` string
      - `value` integer
    - `top_inventors` GooglepatentsFacetEntry[]
      - `key` string
      - `value` integer
    - `total_pages` integer
    - `total_results` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)