google_patents
Search patent records across Google Patents with advanced filters for inventor, assignee, date, country, language, status, type, and litigation.
Instructions
Searches patent records across Google Patents with advanced filtering by inventor, assignee, date range, country, language, status, type, and litigation status. [Credits: 5 API credits per request] Notes: Pagination uses page (0-indexed) plus num for page size. patent_id values returned (e.g. patent/US7520532B2/en) are the format needed - note this differs slightly from the plain publication_number format (e.g. US7520532B2) expected by google_patent_details' patent_id parameter; strip the 'patent/' prefix and '/en' suffix when passing to google_patent_details. Returns: { organic_results: [ { position, patent_id, title, priority_date, filing_date, grant_date, inventor, assignee, publication_number } ] }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| num | No | Number of results to scrape, between 1 and 100. (default: 10) | |
| dups | No | Deduplication method: default is by Family. Available value: language (deduplicate by Publication). | |
| page | No | Page number of results. 0 = first page, 1 = second page, etc. (default: 0) | |
| sort | No | Sorting method. Default is Relevance. Allowed: new (Newest), old (Oldest). For patents, sorting is by filing date; for scholar results, by publication date. | |
| type | No | Filter by patent type. Allowed: PATENT (Patent), DESIGN (Design). | |
| after | No | Minimum date for results, format type:YYYYMMDD where type is priority, filing, or publication. Example: publication:20230101. | |
| query | Yes | Search query. Multiple search terms can be separated with a semicolon (;). Example single term: (Coffee) OR (Tea). Example multi-term: (Coffee) OR (Tea);(A47J). See 'About Google Patents' for advanced syntax. | |
| before | No | Maximum date for results, format type:YYYYMMDD where type is priority, filing, or publication. Example: priority:20221231. | |
| status | No | Filter by patent status. Allowed: GRANT (Grant), APPLICATION (Application). | |
| country | No | Filter by country code(s). Separate multiple codes with a comma. Example: WO,US. | |
| patents | No | Whether to include Google Patents results. (default: true) | |
| scholar | No | Whether to include Google Scholar results. (default: false) | |
| assignee | No | Filter by assignee(s). Separate multiple assignees with a comma. | |
| inventor | No | Filter by inventor(s). Separate multiple inventors with a comma. | |
| language | No | Filter by language(s), comma-separated. Supported: ENGLISH, GERMAN, CHINESE, FRENCH, SPANISH, ARABIC, JAPANESE, KOREAN, PORTUGUESE, RUSSIAN, ITALIAN, DUTCH, SWEDISH, FINNISH, NORWEGIAN, DANISH. | |
| clustered | No | How results should be grouped. Available option: true (Classification). | |
| litigation | No | Filter by litigation status. Allowed: YES (Has Related Litigation), NO (No Known Litigation). |