---
title: "Search Patents"
method: GET
path: "/google-patents/search"
tags: ["Google Patents API"]
---

# Search Patents

`GET /google-patents/search`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/google-patents/search`
- Auth: API key in header `X-API-KEY`

Search for patents on Google Patents using keywords, filters, and date ranges.
Supports Boolean operators, country filtering, patent status, and sorting by date.

## Query parameters

- `q` string, required
- `page` integer, nullable
- `num` integer, nullable
- `sort` 'new' | 'old' | 'null', nullable
- `before` string, nullable
- `after` string, nullable
- `country` string, nullable
- `language` string, nullable
- `status` 'GRANT' | 'APPLICATION' | 'null', nullable
- `type` 'PATENT' | 'DESIGN' | 'null', nullable
- `inventor` string, nullable
- `assignee` string, nullable

## Response `200`

- object
  - `success` boolean, required
  - `data` object, required
    - `total_results` integer, required
    - `total_pages` integer, required
    - `current_page` integer, required
    - `patents` object[], required
      - `patent_id` string, required
      - `rank` integer, required
      - `title` string, required
      - `snippet` string, required
      - `publication_number` string, required
      - `language` string, required
      - `dates` object, required
      - `inventor` string, required
      - `assignee` string, required
      - `thumbnail` string, nullable, required
      - `pdf` string, nullable, required
      - `family_status` object[], required

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `422`: One or more parameters failed validation
- `500`: Service temporarily unavailable or failed to fetch data from Google Patents

---

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