# Goole Patents

**SERP API谷歌查詢參數**

透過Thordata的SERP API配置谷歌搜索查詢，支援日期範圍參數、參與人數、分頁及進階參數輸出選項的定制功能。

<details>

<summary><strong><code>q</code> ，</strong>搜尋查詢<strong>(必填)</strong></summary>

定義用於數據抓取的搜索查詢（默認值：`q=pizza`）。支持任何語言的任意關鍵詞。

**範例請求：**
\
使用參數`q=pizza` 的範例值

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1"
```

</details>

## 日期範圍

<details>

<summary><strong><code>before</code>,</strong>在日期之前<strong>(非必填)</strong></summary>

參數用於限定結果的最晚日期。此欄位格式為“類型:YYYYMMDD”，其中類型可以是優先權日（`priority`）、申請日（`filing`）或公佈日（`publication`）三種。

範例：

`priority:20241231`

`filing:20250615`

`publication:20250101`

**範例請求：**
\
使用參數的範例值： `q` : <mark style="color:blue;">pizza</mark> ,`before`:priority:20241231

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1" \
 -d "before=priority:20241231"
```

</details>

<details>

<summary><strong><code>after</code> ,</strong>在日期之後<strong>(非必填)</strong></summary>

數用於限定結果的最早日期。此欄位格式為“類型:YYYYMMDD”，其中類型可以是優先權日（`priority`）、申請日（`filing`）或公佈日（`publication`）三種。

範例：

`priority:20241231`

`filing:20250615`

`publication:20250101`

**範例請求：**
\
使用參數的範例值： `q` : <mark style="color:blue;">pizza</mark>,`after`: filing:20250615

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1" \
 -d "after=filing:20250615"
```

</details>

## 參與者

<details>

<summary><code>inventor</code>,發明家<strong>(非必填)</strong></summary>

參數定義專利的發明家。多個發明家之間以`,`逗號分隔。

**範例請求：**
\
使用參數的範例值： `q` : <mark style="color:blue;">pizza</mark>,`location`:<mark style="color:blue;">India</mark>,`inventor`:A,B

```json
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1" \
 -d "inventor=A,B" \
 -d "assignee=A,B"
```

</details>

<details>

<summary><code>assignee</code> <strong>,</strong>受讓人<strong>(非必填)</strong></summary>

參數定義專利的受讓人。多個受讓人之間以`,`逗號分隔。

**範例請求：**
\
使用參數的範例值： `q` : <mark style="color:blue;">pizza</mark>,`location`:<mark style="color:blue;">India</mark>,`assignee`:A,B

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1" \
 -d "inventor=A,B" \
 -d "assignee=A,B"
```

</details>

## 分頁

<details>

<summary><strong><code>page</code> ,</strong>頁碼<strong>(非必填)</strong></summary>

此參數定義頁碼。用於分頁。（例如，`1`（預設）表示結果的第一頁，2表示結果的第二頁，等等）。

**範例請求：**
\
使用參數的範例值： `q` : <mark style="color:blue;">pizza</mark>,`page`:<mark style="color:blue;">30</mark>

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1" \
 -d "page=30"
```

</details>

<details>

<summary><strong><code>num</code> ,</strong>每頁結果數<strong>(非必填)</strong></summary>

參數控制每頁的結果數。最小值：10，最大值：100。

**範例請求：**
\
使用參數的範例值： `q` : <mark style="color:blue;">pizza</mark>,`num`:<mark style="color:blue;">20</mark>

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1" \
 -d "num=20"
```

</details>

## 高級參數

<details>

<summary><code>sort</code><strong>,</strong>排序依據<strong>(非必填)</strong></summary>

參數定義排序方法。預設情況下，結果會依相關性排序。\
`new` - Newest\
`old` - Oldest

**範例請求：**
\
使用參數的範例值： `q` : <mark style="color:blue;">pizza</mark>,`sort`:new

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1" \
 -d "sort=new"
```

</details>

<details>

<summary><code>clustered</code> <strong>,</strong>聚類<strong>(非必填)</strong></summary>

參數定義結果的分組方式。

支援的值列表如下：

`true`- 分類

**範例請求：**
\
使用參數的範例值： `q` : <mark style="color:blue;">pizza</mark>,`clustered`:ture

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1" \
 -d "clustered=ture"
```

</details>

<details>

<summary><code>dups</code> <strong>,</strong>删除<strong>(非必填)</strong></summary>

參數定義重複資料刪除方法。可以是 `Family`（預設）或 `Publication`。

支援的值列表如下：

`language`- Publication

**範例請求：**
\
使用參數的範例值： `q` : <mark style="color:blue;">pizza</mark>,`dups`:language

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1" \
 -d "dups=language"
```

</details>

<details>

<summary><code>patents</code> <strong>,</strong>包括專利結果<strong>(非必填)</strong></summary>

此參數控制是否包含 Google Patents 搜尋結果。（預設為 `true`）

**範例請求：**
\
使用參數的範例值： `q` : <mark style="color:blue;">pizza</mark>,`patents`:ture

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1" \
 -d "patents=ture"
```

</details>

<details>

<summary><code>scholar</code><strong>,</strong>包括學者結果<strong>(非必填)</strong></summary>

參數控制包括學者結果。(默认为false)

**範例請求：**
\
使用參數的範例值：`q` : <mark style="color:blue;">pizza</mark>,`scholar`:ture

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer bb33aa0ec81de3fef7a61e9dddec973e" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1" \
 -d "scholar=ture"
```

</details>

如需進一步幫助，請透過 **<support@thordata.com>** 聯繫我們。