Google Scholar API
学术文章搜索、引用文章、版本查询、分页和计费说明。
使用 GoAnyAPI 搜索学术文章，按语言、年份和排序筛选，探索引用文章及文章版本。
测试 Google Scholar API →接口与鉴权
GET https://api.goanyapi.com/api/v1/google-scholarAuthorization: Bearer YOUR_API_KEY当前配置下，每次成功请求消耗 1 积分。
非空成功结果按当前配置扣费，每页独立计费；空结果、参数错误及失败不扣费。
请求参数
| 参数 | 类型 | 必填 | 说明与约束 |
|---|---|---|---|
query | string | 否 | 搜索词，最多 8192 UTF-8 字节；未传 cites 或 cluster 时必填，可搭配 cites，不可搭配 cluster。 最大字符数：8192 machine learning |
language | string | 否 | 界面语言代码，例如 en 或 zh-CN；省略时使用搜索默认语言。 最大字符数：20 ^[A-Za-z]{2,3}(?:-[A-Za-z]{2,4})?$en |
page | integer | 否 | 页码从 1 开始；未传 start 时默认 1，与 start 互斥。 默认值： 11 – 100 1 |
cites | string | 否 | 从 cited_by_url 取得 Scholar 文章数字 ID，多个 ID 用逗号分隔；查询引用文章，可用 query 缩小范围，与 cluster 互斥。 最大字符数：1024 ^[0-9]+(?:,[0-9]+)*$1234567890123456789 |
cluster | string | 否 | 从 versions_url 取得 Scholar 数字聚类 ID，查询文章版本；与 query、cites 互斥。 最大字符数：100 ^[0-9]+$1234567890123456789 |
as_ylo | integer | 否 | 发表年份下限，含该年，不得大于 as_yhi。 1 – 9999 |
as_yhi | integer | 否 | 发表年份上限，含该年，不得小于 as_ylo。 1 – 9999 |
scisbd | integer | 否 | 排序：0 相关性，1 最新摘要，2 最新文章；默认 0。 0 / 1 / 2 默认值： 00 – 2 |
filter | integer | 否 | 相似及省略结果过滤：1 开启，0 关闭；省略时使用搜索默认值。 0 / 1 0 – 1 |
as_vis | integer | 否 | 仅引用记录：1 排除，0 包含；省略时使用搜索默认值。 0 / 1 0 – 1 |
as_rr | integer | 否 | 综述筛选：1 仅综述，0 全部文章类型；省略时使用搜索默认值。 0 / 1 0 – 1 |
start | integer | 否 | 结果偏移量从 0 开始，与 page 互斥。 0 – 990 |
num | integer | 否 | 请求每页条数，默认 10；实际条数可能更少。 默认值： 101 – 20 |
lr | string | 否 | 结果语言限制，使用 lang_<code>，多个语言以 | 分隔，例如 lang_fr|lang_de。 最大字符数：256 ^lang_[A-Za-z-]+(?:\|lang_[A-Za-z-]+)*$lang_fr|lang_de |
as_sdt | string | 否 | 原生文章/专利筛选或逗号分隔的法院代码，例如 4,33,192。 最大字符数：256 ^[0-9]+(?:,[0-9]+)*$0 |
device | string | 否 | 设备类型：desktop、mobile、tablet；省略时使用搜索默认值。 desktop / mobile / tablet 最大字符数：8192 |
safe | string | 否 | 安全搜索：active 开启过滤，off 请求不过滤。 active / off 最大字符数：8192 |
本接口仅返回结构化 JSON。不接受未列出的参数、重复参数或空参数；不使用的参数请省略。页码范围 1–100，偏移范围 0–990，每页条数范围 1–20 是本接口的公开限制。
查询方式
- 关键词搜索：填写
query，例如machine learning。 - 引用文章：填写
cites，可同时用query缩小范围。从返回的cited_by_url中提取数字cites参数，多个 ID 用逗号分隔。 - 文章版本：填写
cluster，不能同时填写query或cites。从versions_url中提取数字cluster参数。
results[].id 不保证是 cites 或 cluster ID，不要直接替代。作者详情和引用格式导出不属于本接口。
scisbd 的全部取值为 0（相关性）、1（最新摘要）、2（最新文章）。年份范围包含边界年份，as_ylo 不得大于 as_yhi。仅指定一个年份边界也有效。
请求示例
GET /api/v1/google-scholar?query=machine%20learning&language=en&page=1
Authorization: Bearer YOUR_API_KEY引用与版本请求格式示例（数字 ID 仅示意格式，实际调用请使用响应链接中的 ID）：
GET /api/v1/google-scholar?cites=1234567890123456789&query=review
GET /api/v1/google-scholar?cluster=1234567890123456789分页
page 从 1 开始，或使用从 0 开始的 start；二者互斥。省略时从第一页开始，num 默认 10。保持查询和筛选条件一致，每次只查询一页，不自动遍历。has_next_page 存在时按实际值使用，不推算总条数或虚构下一页状态。
响应字段
| 字段 | 含义 |
|---|---|
data.endpoint | google-scholar |
data.query | 实际请求参数 |
data.costCredits | 本次实际扣除积分 |
data.remainingCredits | 剩余积分 |
data.result.format | json |
data.result.content.results[] | 学术文章记录 |
data.result.content.results[].title / url / snippet | 标题、链接和摘要 |
data.result.content.results[].publication_info | 发表信息 |
data.result.content.results[].cited_by / cited_by_url | 引用信息和引用文章入口 |
data.result.content.results[].versions / versions_url | 版本信息和版本入口 |
data.result.content.results[].resource | 文章资源信息 |
data.result.content.has_next_page | 有返回时表示分页状态 |
业务字段按实际结果返回，允许 null、空字符串、空数组或缺失。不补造标题、引用数或作者；缺失展示字段不会导致整条记录被丢弃。空结果成功返回且不扣费。
错误处理
参数错误返回 400 invalid_params，未鉴权返回 401，余额不足返回 402 insufficient_credits，限流返回 429，搜索失败或无效响应返回 502 request_failed，服务未配置返回 503 service_not_configured。错误不扣费。检查参数和鉴权；临时搜索错误可稍后重试。