# Google Scholar

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

使用 Thordata 的 SERP API 配置谷歌搜索查詢，包括本地化參數、地理位置、分頁、以及「高級參數」等輸出選項。

<details>

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

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

**示例請求：**

使用`q`：<mark style="color:blue;">pizza</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_scholar" \
 -d "q=pizza" \
 -d "json=1"
```

</details>

## 本土化

<details>

<summary><strong><code>hl</code> ，語言（非必填）</strong>
</summary>

設定搜尋結果的介面語言（預設值：`en`）。採用標準語言代碼格式（例如：`en`-英文，`es`-西班牙文，`zh-CN`-簡體中文）。
\
完整語言代碼支援清單請參閱：[Google官方語言代碼表](https://developers.google.com/google-ads/api/docs/start)

**示例請求：**

查询`q` ：<mark style="color:blue;">pizza</mark>,`hl`： <mark style="color:blue;">es</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_scholar" \
 -d "q=pizza" \
 -d "json=1" \
 -d "hl=es"
```

</details>

<details>

<summary><strong><code>lr</code>，設置多語言（非必填）</strong></summary>

使用 `lang_XX` 代碼（如 `lang_fr|lang_de`）依語言篩選結果。

若同時使用 `hl` 參數，此參數將覆蓋 `hl` 設定。

`hl` 與 `lr` 參數可同時使用，但實際效果以 `lr` 參數為優先。

**示例請求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`lr`: <mark style="color:blue;">lang\_en|lang\_fr</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_scholar" \
 -d "q=pizza" \
 -d "json=1" \
 -d "lr=lang_fr|lang_en"
```

</details>

## 地理位置

<details>

<summary><strong><code>location</code>，地理位置(非必填)</strong></summary>

模擬從精確位置發起搜尋（需搭配 `uule` 參數使用）。若未指定，系統可能採用代理伺服器的地理位置。

**示例請求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`location`:<mark style="color:blue;">India</mark>,`uule`:<mark style="color:blue;">w+CAIQICIFSW5kaWE</mark>的示例結果

```
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_scholar" \
 -d "q=pizza" \
 -d "json=1" \
 -d "location=India" \
 -d "uule=w+CAIQICIFSW5kaWE"
```

</details>

<details>

<summary><strong><code>uule</code> ，</strong>編碼位置<strong>(非必填)</strong></summary>

使用 `Base64` 編碼目標地理位置（需配合 `location` 參數使用）

**示例請求：**

查询  `q` : <mark style="color:blue;">pizza</mark>,`location`:<mark style="color:blue;">India</mark>,`uule`:<mark style="color:blue;">w+CAIQICIFSW5kaWE</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_scholar" \
 -d "q=pizza" \
 -d "json=1" \
 -d "location=India" \
 -d "uule=w+CAIQICIFSW5kaWE"
```

</details>

## 搜索類型

<details>

<summary><strong><code>as_sdt</code> ，搜索類型（非必填）</strong></summary>

此參數可用作搜尋類型或篩選器。 作為過濾器（僅在搜尋文章時有效）： `0`- 排除專利（預設）。 - `7`包含專利。 作為搜尋類型： `4`- 選擇判例法（僅限美國法院）。這將選擇所有州和聯邦法院。

**示例請求：**

查询  `q` : <mark style="color:blue;">pizza</mark>,`as_sdt`:<mark style="color:blue;">4</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_scholar" \
 -d "q=pizza" \
 -d "json=1" \
 -d "as_sdt=4"
```

</details>

## 分頁

<details>

<summary><strong><code>start</code> ，結果偏移量（非必填）</strong></summary>

此參數定義結果偏移量。它會跳過指定數量的結果。它用於分頁。 （例如，0（預設值）表示第一頁結果，10 表示第二頁結果，20 表示第三頁結果，以此類推。）

**示例請求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`start`:<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_scholar" \
 -d "q=pizza" \
 -d "json=1" \
 -d "start=30"
```

</details>

<details>

<summary><strong><code>num</code> ，煤業結果數（非必填）</strong></summary>

設定搜尋結果每頁回傳的最大數量（例如：`num=10` 表示每頁回傳10筆結果）。

**示例請求：**

查询 `cq` : <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_scholar" \
 -d "q=pizza" \
 -d "json=1" \
 -d "num=20"
```

</details>

## 高級參數

<details>

<summary><strong><code>cites</code> ,</strong>引用<strong>（非必填）</strong></summary>

参数定义文章的唯一 ID，用于触发“被引文献”搜索。使用`cites`将显示 Google 学术搜索中的引用文献列表。示例值：`cites=1275980731835430123`。使用`cites`和`q`参数将在引用文献中触发搜索。

**示例請求：**

查询`q` : <mark style="color:blue;">pizza</mark>,`cites`:1275980731835430123的示例

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

</details>

<details>

<summary><strong><code>as_ylo</code> ,</strong>開始年份<strong>非必填）</strong></summary>

此參數定義了您希望包含結果的年份。此參數可以與`as_yhi`參數結合使用。

**示例請求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`as_ylo`:<mark style="color:blue;">2022</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_scholar" \
 -d "q=pizza" \
 -d "json=1" \
 -d "as_ylo=2022"
```

</details>

<details>

<summary><strong><code>as_yhi</code> ,</strong>結束年份<strong>（非必填）</strong></summary>

此參數定義了您希望包含結果的年份。此參數可以與`as_yhi`參數結合使用。

**示例請求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`as_ylo`:<mark style="color:blue;">2025</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_scholar" \
 -d "q=pizza" \
 -d "json=1" \
 -d "as_ylo=2022" \
 -d "as_yhi=2025"
```

</details>

<details>

<summary><strong><code>scisbd</code> ,</strong>按日期排序<strong>（非必填）</strong></summary>

此參數定義去年新增的文章，依日期排序。可設定為`1`僅包含摘要，或`2`包含所有內容。預設值為，`0`表示文章依相關性排序。

**示例請求：**

查询`q` : <mark style="color:blue;">pizza</mark>,`cisbd`:<mark style="color:blue;">1</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_scholar" \
 -d "q=pizza" \
 -d "json=1" \
 -d "scisbd=1"
```

</details>

<details>

<summary><strong><code>cluster</code>,</strong>版本<strong>非必填）</strong></summary>

參數 `cluster` 用於定義文章的唯一ID，以觸發「所有版本」搜尋。範例值：`cluster=1275980731835430123`。禁止 `cluster` 與 `q` 和 `cites` 參數同時使用。請僅使用 `cluster` 參數。

**示例請求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`cluster`:1275980731835430123的示例

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

</details>

## 高級篩選

<details>

<summary><strong><code>safe</code> ，</strong>成人內容過濾<strong>（非必填）</strong></summary>

此參數用於設定是否過濾成人內容（預設值：依Google政策）。可指定值：

* `active`：啟用嚴格過濾
* `off`：完全停用過濾\
  （注意：即使設為`off`，Google仍可能對露骨內容進行模糊化處理

**示例請求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`safe`:<mark style="color:blue;">active</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_scholar" \
 -d "q=pizza" \
 -d "json=1" \
 -d "safe=active"
```

</details>

<details>

<summary><strong><code>nfpr</code> ，排除自動更正結果（非必填）</strong></summary>

此參數用於設定是否停用搜尋關鍵字自動校正功能，例如：

* `nfpr=1`：啟用嚴格模式（輸入「googl」將不會自動校正為「google」）
* `nfpr=0`：使用預設自動校正功能

**示例請求：**

查询  `q` : <mark style="color:blue;">pizza</mark>,`nfpr`:<mark style="color:blue;">1</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_scholar" \
 -d "q=pizza" \
 -d "json=1" \
 -d "nfpr=1"
```

</details>

<details>

<summary><strong><code>filter</code> ，結果篩選（非必填）</strong></summary>

此參數用於控制搜尋結果去重功能：

* `1`：啟用結果去重（移除重複內容）
* `0`：停用結果去重（顯示完整結果）

**示例请求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`filter`:1的示例

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

</details>

<details>

<summary><code>as_vis</code> <strong>,顯示引用（非必填）</strong></summary>

此參數定義您是否要包含引用。您可以將其設定為`1`排除這些結果，或`0`（預設）將其包含。

**示例請求：**

查询`q` : <mark style="color:blue;">pizza</mark>,`as_vis`:<mark style="color:blue;">1</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_scholar" \
 -d "q=pizza" \
 -d "json=1" \
 -d "as_vis=1"
```

</details>

<details>

<summary><code>as_rr</code> <strong>,顯示評論文章（非必填）</strong></summary>

此參數定義您是否希望僅顯示評論文章（這些文章包含主題評論，或討論您搜尋的作品或作者）。您可以設定為`1`啟用此過濾器，或`0`（預設）顯示所有結果。

**示例請求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`as_rr`:<mark style="color:blue;">1</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_scholar" \
 -d "q=pizza" \
 -d "json=1" \
 -d "as_rr=1"
```

</details>

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