URL 콘텐츠 추출
하나 이상의 URL을 넘기면 내비게이션과 광고가 제거된 깔끔한 본문 콘텐츠를 돌려받습니다. RAG 파이프라인, 에이전트의 스크랩·요약 플로, 콘텐츠 모니터링 작업에 바로 사용할 수 있습니다.
통합 가이드
스니펫을 복사하고 API 키를 교체한 뒤 실행하세요. 모든 HTTP 클라이언트에서 작동합니다 — 아래에 cURL, JavaScript, Python 예제가 있습니다.
/api/extracthttps://www.apipick.comExtract clean readable content from one or more URLs. Removes navigation, ads, and boilerplate. Returns markdown-flavoured text ready for LLM ingestion.
urlsarray<string>필수1–25 http(s) URLs
extract_effortstring선택auto | low | high
response_lengthstring선택short | medium | long
curl -X POST "https://www.apipick.com/api/extract" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"urls": [
"https://en.wikipedia.org/wiki/Retrieval-augmented_generation",
"https://docs.anthropic.com/claude/docs/intro-to-claude"
],
"extract_effort": "auto"
}'{
"results": [
{
"url": "https://en.wikipedia.org/wiki/Retrieval-augmented_generation",
"title": "Retrieval-augmented generation - Wikipedia",
"content": "Retrieval-augmented generation (RAG) is a technique…",
"status": "ok"
}
],
"result_count": 1,
"credits_used": 2,
"remaining_credits": 98
}요청 제한
스로틀링은 API 키 단위, 60초 슬라이딩 윈도우입니다. 한도에 도달하면 Retry-After 헤더가 포함된 깔끔한 429를 받습니다.
30req/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: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded: 30 requests/minute per API key. Retry after 12s.",
"retry_after": 12
}자주 묻는 질문
크레딧은 어떻게 청구되나요?
제출한 URL당 2 크레딧입니다. URL 5개를 한 번에 호출하면 10 크레딧이 듭니다. 호출당 최대 25개 URL까지 가능합니다.
응답은 어떤 형태인가요?
{ url, title, content, status } 객체의 배열입니다. content는 보일러플레이트가 제거된 깔끔한 본문 텍스트(마크다운풍)로, LLM이 바로 소비하기에 적합합니다.
추출 깊이를 조절할 수 있나요?
extract_effort(auto, low, high)를 전달하세요. 'auto'가 기본값이며 대부분의 페이지에서 잘 작동합니다. 'high'는 느리지만 JS가 많거나 페이월 형태의 페이지에서 더 철저하게 처리합니다.
URL이 실패하면 어떻게 되나요?
실패한 URL은 결과 배열에서 status가 오류 코드로 설정되어 반환되지만, 호출 전체는 성공으로 처리됩니다. 개별 URL의 결과와 관계없이 제출한 모든 URL에 대해 크레딧이 청구됩니다.
도구 스키마가 있나요?
GET /api/extract/tool-schema가 OpenAI 함수와 Claude 도구 사용 정의를 반환합니다.