# 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>** 聯繫我們。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.thordata.com/doc/zh-hk/pa-qu/serp-api/cha-xun-can-shu/gu-ge/google-scholar.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.