# 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>联系我们。