데이터셋 리서치 API
전문 데이터셋 컬렉션에 대해 질문하면 인용이 달린 답변을 돌려받습니다. 이 데이터셋은 리서치 실행을 통해서만 접근할 수 있어 API가 비동기로 동작합니다. 작업을 시작한 뒤 답변이 준비될 때까지 폴링하세요. 보통 15초에서 2.5분이 걸립니다.
데이터셋 리서치 API란?
하나의 컬렉션으로 범위를 지정한 리서치 작업을 시작하고 작업 id를 반환합니다. 작업을 폴링하면 상태가 반환되며, 완료되면 번호 인용이 포함된 Markdown 답변과 출처 목록이 반환됩니다.
- 엔드포인트
- POST /api/research
- 인증
- API 키 · x-api-key 헤더
- 비용
- 100 크레딧 / 호출
- 속도 제한
- 20 요청 / 분
- 응답
- 구조화된 JSON
통합 가이드
스니펫을 복사하고 API 키를 교체한 뒤 실행하세요. 모든 HTTP 클라이언트에서 작동합니다 — 아래에 cURL, JavaScript, Python 예제가 있습니다.
/api/researchhttps://www.apipick.com하나의 컬렉션으로 범위를 지정한 리서치 작업을 시작하고 작업 id를 반환합니다. 작업을 폴링하면 상태가 반환되며, 완료되면 번호 인용이 포함된 Markdown 답변과 출처 목록이 반환됩니다.
querystring필수The research question (max 2000 characters)
collectionstring필수vehicle-safety | short-sellers | sanctions
curl -X POST "https://www.apipick.com/api/research" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"query": "What recalls and NHTSA investigations exist for the 2021 Tesla Model Y?",
"collection": "vehicle-safety"
}'{
"query": "What recalls and NHTSA investigations exist for the 2021 Tesla Model Y?",
"answer": "**Summary:** … [[1]](https://example.com/source)",
"results": [
{
"title": "Example source",
"url": "https://example.com/source",
"snippet": "Short excerpt the answer cites…"
}
],
"result_count": 1,
"credits_used": 100,
"remaining_credits": 99
}요청 제한
스로틀링은 API 키 단위, 60초 슬라이딩 윈도우입니다. 한도에 도달하면 Retry-After 헤더가 포함된 깔끔한 429를 받습니다.
20req/min
API 키별, 엔드포인트별. 60초 슬라이딩 윈도우.
3concurrent
API 키당 동시에 처리 중인 최대 요청 수.
X-RateLimit-Limit분당 허용되는 최대 요청 수X-RateLimit-Remaining현재 윈도우에 남은 요청 수X-RateLimit-Reset현재 윈도우가 초기화되기까지의 초Retry-After재시도 전 대기 초 (429일 때만)HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 20
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded: 20 requests/minute per API key. Retry after 12s.",
"retry_after": 12
}자주 묻는 질문
인용 답변은 동기식인데 왜 이건 비동기인가요?
이 컬렉션들로 범위를 지정한 리서치는 15초에서 약 2.5분으로 더 오래 걸립니다. POST /api/research는 즉시 task_id를 반환하므로, status가 completed가 될 때까지 몇 초마다 GET /api/research/tasks/{task_id}를 폴링하세요.
어떤 컬렉션을 사용할 수 있나요?
vehicle-safety는 NHTSA 리콜, 차주 불만, 결함 조사, VIN 디코딩을 다룹니다. short-sellers는 행동주의 공매도 기관 보고서와 롱 포지션 펀드의 서한 및 투자 아이디어를 다룹니다. sanctions는 OFAC SDN 및 통합 명단, 유엔, 영국 HMT, 호주 DFAT, 스위스 SECO, 미국 통합 심사 명단(Consolidated Screening List), INTERPOL 적색수배를 다룹니다.
언제 과금되나요?
작업이 완료될 때만 과금됩니다. 답변을 반환하는 첫 폴링에서 100크레딧(약 $0.10)이 차감되며, 같은 작업에 대한 이후 폴링은 무료입니다. 실행 중인 작업을 폴링하는 것도 무료이고, 실패한 작업에는 비용이 들지 않습니다.
제재 컬렉션을 컴플라이언스 심사에 써도 되나요?
아니요. 리서치 보조 도구일 뿐입니다. 답변이 등재 정보를 누락할 수 있으며, 전문 심사 서비스나 공식 명단 대조를 대신할 수 없습니다.
OpenAI / Claude용 도구 스키마는요?
GET /api/research/tool-schema가 바로 붙여넣을 수 있는 OpenAI 함수 및 Claude 도구 사용 정의와 컬렉션 목록을 반환합니다.
다른 검색 API 살펴보기
LLM 도구 호출을 위해 제작된 실시간 시맨틱 웹 검색. 에이전트 소비용으로 미리 정형화된 순위 제목, URL, 깔끔한 스니펫을 반환. 국가·날짜 필터 지원.
주요 매체에 걸친 실시간 뉴스 검색. 시간 민감 쿼리를 위한 날짜 범위·국가 필터링. 아침 브리핑, 시장 뉴스 에이전트, RAG 파이프라인을 위해 제작.
구체적인 질문을 보내면 웹, 뉴스, 전문 데이터셋을 실시간으로 조사해 번호가 매겨진 인용과 함께 짧은 답변을 반환. 한 번의 호출로 끝나며 RAG 파이프라인 구축이 필요 없음.
AP 통신 기사를 스니펫이 아닌 전문으로 검색. 최근 30일 롤링 기간을 커버하며, 시사 정보 그라운딩과 속보 에이전트를 위해 제작.
한 번의 호출로 최대 25개 URL에서 깔끔하고 읽기 쉬운 콘텐츠를 추출. 광고·내비·보일러플레이트 제거 후 LLM이 바로 소비할 수 있는 마크다운풍 텍스트 반환. URL당 2 크레딧.
단일 엔드포인트로 arXiv, PubMed, bioRxiv, medRxiv의 동료 평가 논문과 프리프린트를 검색. AI 기반 문헌 검토, 과학 코퍼스 RAG, 인용 추출을 위해 제작.
임상시험, FDA 약물 라벨, ChEMBL 생물활성을 검색. 의학 연구, 약물 재포지셔닝, AI 기반 임상 의사결정 지원 워크플로를 위해 제작.
SEC 공시(10-K, 10-Q, 8-K), 미국 실적 발표 트랜스크립트, 주식 통계를 검색. AI 기반 실사, 펀더멘털 분석, 금융 RAG 파이프라인을 위해 제작.
USPTO, EPO, WIPO, 주요 국가 특허청에 걸친 글로벌 특허 출원 시맨틱 검색. 선행기술 조사, IP 풍경 분석, AI 기반 경쟁 인텔리전스를 위해 제작.
정치, 경제, 스포츠, 시사에 대한 Polymarket과 Kalshi 예측 시장 계약을 검색. 군중 예측 검색과 LLM 답변의 확률 근거 제공을 위해 제작.
단일 엔드포인트로 영국 판례법과 1차 입법을 시맨틱 검색. 법률 리서치, 컴플라이언스 검토, 법령 해석, AI 기반 리걸테크 워크플로를 위해 제작.
CISA 알려진 악용 취약점(KEV), NVD CVE 레코드, EPSS 악용 점수, MITRE ATT&CK 기법을 검색. AI 기반 취약점 분류, 위협 인텔리전스, 보안 운영을 위해 제작.
글로벌 및 미국 주식, 암호화폐, 외환, ETF, 펀드, 원자재, 미국 마켓 무버를 검색. AI 기반 가격 조회, 시장 데이터 검색, 트레이딩 리서치를 위해 제작.
FRED, 미국 노동통계국, 세계은행 지표, IMF 거시 데이터, 미국 연방 지출, 독일 노동 통계를 검색. AI 기반 거시경제 리서치와 분석을 위해 제작.
미국 상장기업의 재무상태표, 손익계산서, 현금흐름표, 배당, 내부자 거래를 검색. AI 기반 기본적 분석과 실사를 위해 제작.
미국 실적 발표 캘린더에서 예정 보고일, EPS/매출 추정치, 장전/장후 발표 시점을 검색. AI 기반 이벤트 트레이딩과 리서치를 위해 제작.
ChEMBL 생물활성, PubChem 화학 구조, Open Targets 표적-질환 연관성을 검색. AI 기반 신약 개발, 케모인포매틱스, 생의학 연구를 위해 제작.
WHO 글로벌 보건 통계, NIH 연구비, openFDA 약물 이상사례 보고, FDA 의약품·의료기기 리콜을 검색. AI 기반 공중보건 연구와 약물감시를 위해 제작.
영국 의회 토론, 서면 질의, 의원 활동(Hansard)을 검색. AI 기반 시빅테크 도구, 입법 모니터링, 정책 연구를 위해 제작.
EU MiCA 암호자산 규정집 검색: 규정 본문, Level 2 기술 표준, ESMA·EBA 가이드라인, 27개 회원국 전체의 국내법까지.
라이선스가 부여된 Wiley 금융 저널과 교과서를 검색. AI 기반 학술 수준의 금융 연구, 문헌 검토, 투자 분석을 위해 제작.