콘텐츠로 이동

Semantic Scholar API 완전 가이드

S2AG API v1 — 논문, 저자, 인용, 추천, 데이터셋까지 전체 엔드포인트를 다루는 한국어 레퍼런스

가이드 구조

# 파일 제목 EP 내용 요약
1 01-overview 개요 — API 구성, 주요 개념
2 02-common 인증/공통 — API 키, fields, 페이지네이션, ID, 필터, 에러
3 03-paper-search 논문 검색 5 relevance, bulk, title match, autocomplete, snippet
4 04-paper-detail 논문 상세 5 단일/배치 조회, 인용/참조/저자
5 05-author 저자 4 검색, 상세, 배치, 저자별 논문
6 06-recommendations 추천 2 단일/다중 논문 기반 추천
7 07-datasets 데이터셋 4 릴리스, 다운로드, 증분 diff
8 08-data-models 모델 레퍼런스 — 14개 모델 + 래퍼 + 특수 변형
9 09-appendix 부록 — 요약표, 실전 패턴 6개

빠른 참조

엔드포인트 → 파일 매핑

엔드포인트 메서드 파일
/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

데이터 모델 → 파일 매핑

모델 설명 참조
BasePaper 논문 기본 모델 (22 필드) 08-data-models.md § 8.1
FullPaper BasePaper + embedding/tldr/citations/references 08-data-models.md § 8.2
Author 저자 상세 모델 08-data-models.md § 8.3
Citation / Reference 인용/참조 관계 모델 08-data-models.md § 8.5–8.6
응답 래퍼 (4 패턴) offset / offset+total / token / 단순 08-data-models.md § 8.13
특수 변형 모델 Title Match, Autocomplete, PaperInfo 등 08-data-models.md § 8.14