API 사용법

모든 엔드포인트는 GET 방식이며 JSON을 반환합니다. CORS가 활성화되어 있어 브라우저에서도 직접 호출할 수 있습니다.

1. 논문 검색 — GET /search

articles / article_analysis 테이블을 DOI 기준으로 그룹화해 검색합니다. 같은 논문이 pubmed, crossref, kci 중 여러 소스에 있으면 하나로 합쳐집니다.

GET /search?q=검색어&page=1&per_page=20&analyzed=1

파라미터	설명	기본값
q	검색어 (제목·저자·저널·DOI·PMID·PICO·임상요약 부분 일치)	없음
page	페이지 번호	1
per_page	페이지당 개수 (1~10000)	20
analyzed	분석 완료만 (1/true)	false
km	한의학 여부 (1/0)	없음
human	인체 연구 여부 (1/0)	없음
lit	문헌 고찰 여부 (1/0)	없음
cat	연구 유형	없음
source	소스 필터: pubmed, crossref, kci, all	all
ref	대표 행 선택: pubmed, crossref, kci, all	all
pub_from	출판일 시작 (YYYY-MM-DD)	없음
pub_to	출판일 끝 (YYYY-MM-DD)	없음
kw	키워드 필터 (콤마 구분, AND 조건)	없음

/search 응답에는 총 건수/총 페이지 수가 없습니다 — 페이지네이션에 필요하면 같은 파라미터(page 제외)로 아래 엔드포인트를 따로 호출하세요.

2. 검색 결과 총 건수 — GET /search-count

GET /search-count?q=검색어&per_page=20&analyzed=1

3. 전체 통계 — GET /stat

GET /stat

4. 헬스 체크 — GET /health

GET /health

예시 (curl)

curl "https://med.symbolicinfo.com/search?q=cancer&analyzed=1"
curl "https://med.symbolicinfo.com/search?q=acupuncture&km=1&human=1&per_page=50"
curl "https://med.symbolicinfo.com/stat"