Semantic Scholar API Complete Guide¶
S2AG API v1 — A comprehensive reference covering all endpoints for papers, authors, citations, recommendations, and datasets.
Guide Structure¶
| # | File | Title | EP | Summary |
|---|---|---|---|---|
| 1 | 01-overview |
Overview | — | API structure, key concepts |
| 2 | 02-common |
Auth & Common | — | API key, fields, pagination, IDs, filters, errors |
| 3 | 03-paper-search |
Paper Search | 5 | relevance, bulk, title match, autocomplete, snippet |
| 4 | 04-paper-detail |
Paper Detail | 5 | single/batch lookup, citations/references/authors |
| 5 | 05-author |
Author | 4 | search, detail, batch, papers by author |
| 6 | 06-recommendations |
Recommendations | 2 | single/multi-paper recommendations |
| 7 | 07-datasets |
Datasets | 4 | releases, downloads, incremental diffs |
| 8 | 08-data-models |
Model Reference | — | 14 models + wrappers + special variants |
| 9 | 09-appendix |
Appendix | — | summary table, 6 practical patterns |
Quick Reference¶
Endpoint → File Mapping¶
| Endpoint | Method | File |
|---|---|---|
/paper/search |
GET | 03-paper-search.md |
/paper/search/bulk |
GET | 03-paper-search.md |
/paper/search/match |
GET | 03-paper-search.md |
/paper/autocomplete |
GET | 03-paper-search.md |
/snippet/search |
GET | 03-paper-search.md |
/paper/{paper_id} |
GET | 04-paper-detail.md |
/paper/batch |
POST | 04-paper-detail.md |
/paper/{id}/citations |
GET | 04-paper-detail.md |
/paper/{id}/references |
GET | 04-paper-detail.md |
/paper/{id}/authors |
GET | 04-paper-detail.md |
/author/search |
GET | 05-author.md |
/author/{author_id} |
GET | 05-author.md |
/author/batch |
POST | 05-author.md |
/author/{id}/papers |
GET | 05-author.md |
/papers/forpaper/{id} |
GET | 06-recommendations.md |
/papers/ |
POST | 06-recommendations.md |
/release/ |
GET | 07-datasets.md |
/release/{id} |
GET | 07-datasets.md |
/release/{id}/dataset/{name} |
GET | 07-datasets.md |
/diffs/{start}/to/{end}/{name} |
GET | 07-datasets.md |
Data Model → File Mapping¶
| Model | Description | Reference |
|---|---|---|
BasePaper |
Base paper model (22 fields) | 08-data-models.md § 8.1 |
FullPaper |
BasePaper + embedding/tldr/citations/references | 08-data-models.md § 8.2 |
Author |
Author detail model | 08-data-models.md § 8.3 |
Citation / Reference |
Citation/reference relationship models | 08-data-models.md § 8.5–8.6 |
| Response Wrappers (4 patterns) | offset / offset+total / token / simple | 08-data-models.md § 8.13 |
| Special Variant Models | Title Match, Autocomplete, PaperInfo, etc. | 08-data-models.md § 8.14 |