# Google Scholar

**SERP  API 谷歌 Search查询参数**

使用 Thordata的 SERP API 配置谷歌搜索查询，包括本地化参数、地理位置、分页、以及“高级参数”输出选项。

<details>

<summary><strong><code>q</code> ，搜索查询(必填)</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`。

&#x20;`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>的示例结果

```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>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><code>as_sdt</code> <strong>，搜索类型（非必填）</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>

该参数定义了搜索结果每页返回的最大数。例如：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><code>cites</code> <strong>,引用（非必填）</strong></summary>

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

**示例请求：**

查询`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><code>as_ylo</code> <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><code>as_yhi</code> <strong>,结束年份（非必填）</strong></summary>

该参数定义了您希望包含结果的年份。此参数可以与`as_ylo`参数结合使用。

**示例请求：**

查询 `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><code>scisbd</code> <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><code>cluster</code><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>

该参数定义了搜索结果是否屏蔽成人内容。您可设置为 `active` 或者 `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”

**示例请求：**

查询  `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/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.