KYC 없음 — 신분증도, 셀피도, 서류도 없습니다. 암호화폐로 결제하세요: BTC, USDT, USDC, ETH, SOL, LTC
언어: 한국어
API 키 발급받기

문서 · 빠른 시작

URL to Markdown API 빠른 시작: 2분 만에 첫 페이지 읽기

하나의 endpoint, 하나의 parameter: URL을 /read으로 보내면 페이지의 본문 추출 결과를 Markdown으로 돌려받습니다. 이 페이지는 잔액이 비어 있는 상태에서 작동하는 호출까지 안내하고, 그다음 다른 모든 내용을 알려줍니다.

마지막 업데이트: · 4 분 읽기

빠른 답변

API로 URL을 Markdown으로 변환하려면 어떻게 하나요?

URL을 Authorization header에 API 키와 함께 GET https://webreaderapi.com/api/v1/read으로 보내세요. WebReaderAPI은 페이지를 가져와 본문 추출 결과를 제목, 저자, 날짜, 단어 수와 함께 Markdown으로 반환합니다. 한 페이지에 크레딧 1개(브라우저가 필요하면 2개)가 들며, 2026년 10월 기준 US$0.07/1K 페이지부터입니다. KYC 없이; 암호화폐 결제.

한눈에 보는 API 표

Base URLhttps://webreaderapi.com/api/v1
페이지 하나 읽기GET 또는 POST https://webreaderapi.com/api/v1/read
여러 URL 또는 사이트 하나POST https://webreaderapi.com/api/v1/batch 및 POST https://webreaderapi.com/api/v1/crawl, GET https://webreaderapi.com/api/v1/jobs/{job_id}부터 결과
남은 크레딧GET https://webreaderapi.com/api/v1/credits (무료)
인증API 키를 Bearer 토큰으로 Authorization 헤더에 넣거나 api_key 쿼리 파라미터에 넣어 전송하세요
과금1 크레딧 = 브라우저 없이 페이지 1회 읽기, 페이지가 JavaScript를 렌더링하는 데 브라우저가 필요하면 2 크레딧. 실패한 요청이나 사이트의 robots.txt가 거부한 요청은 과금되지 않습니다
저희 크롤러WebReaderAPI/1.0 (+https://webreaderapi.com/bot/), robots.txt token WebReaderAPI
가장 작은 팩US$3.75에 10,000페이지; 크레딧은 만료되지 않습니다

API 키는 어떻게 받나요?

세 단계면 되고, 작성할 양식도 없습니다. 가장 오래 걸리는 단계는 충전금의 블록체인 컨펌입니다.

  1. 암호화폐로 충전

    BTC, USDT, USDC, ETH, SOL, LTC로 최소 US$25을 보내세요. 계정 번호로 로그인, 이메일은 선택 사항.

  2. 크레딧 팩 구매하기

    US$3.75에 대한 10,000페이지이면 본인의 URL로 모든 옵션을 직접 테스트하기에 충분합니다.

  3. 키 복사

    암호화폐 충전이 확인되고 팩을 구매하면 대시보드에서 API 키를 바로 사용할 수 있습니다. WEBREADER_API_KEY라는 이름의 환경 변수에 저장하세요.

첫 요청은 어떻게 생겼나요?

페이지 주소를 url 파라미터에 담아 보내는 일반 HTTPS GET입니다. 주소 자체에 :, / 문자가 들어 있으므로 인코딩해야 하는데, curl은 --data-urlencode을 쓰면 알아서 처리합니다. 기본 설정은 대부분의 아티클과 문서 페이지에 이미 맞춰져 있습니다: Markdown 출력, 본문만, 페이지가 필요로 할 때만 브라우저 사용.

curl: 페이지 하나 읽기
curl -sG "https://webreaderapi.com/api/v1/read" \
  -H "Authorization: Bearer $WEBREADER_API_KEY" \
  --data-urlencode "url=https://example.com/blog/first-post"
Python: 페이지 하나 읽고 저장하기
import os

import requests

resp = requests.get(
    "https://webreaderapi.com/api/v1/read",
    headers={"Authorization": "Bearer " + os.environ["WEBREADER_API_KEY"]},
    params={"url": "https://example.com/blog/first-post"},
    timeout=70,
)
resp.raise_for_status()
page = resp.json()
print(page["title"], "-", page["word_count"], "words,", page["credits_used"], "credit(s)")
with open("first-post.md", "w", encoding="utf-8") as f:
    f.write(page["markdown"])
Node.js 18+: 페이지 하나 읽기
const params = new URLSearchParams({ url: 'https://example.com/blog/first-post' });
const res = await fetch(`https://webreaderapi.com/api/v1/read?${params}`, {
  headers: { Authorization: `Bearer ${process.env.WEBREADER_API_KEY}` },
});
const page = await res.json();
if (!res.ok) throw new Error(`${page.error.code}: ${page.error.message}`);
console.log(page.title, page.word_count, 'words');
console.log(page.markdown.slice(0, 500));

무엇이 반환되나요?

markdown 필드에 Markdown이, 그 옆에 페이지 메타데이터가 담긴 JSON 객체입니다: title, description, author, published_at, language, site_name, word_count. 무슨 일이 있었는지 확인하는 데 도움이 되는 필드가 두 개 있습니다: final_url는 리다이렉트 후의 주소이고, rendered은 브라우저가 필요했는지 알려줍니다.

credits_used은 호출 비용을 보여줍니다: 일반 페이지면 1, rendered가 true이면 2, country를 선택했다면 1이 더해집니다. response format 페이지에 모든 필드와 예시가 나와 있습니다.

어떤 옵션을 가장 많이 쓰게 되나요?

다섯 개 파라미터면 대부분의 요구를 커버합니다. 모두 선택 사항입니다.

파라미터용도
formatmarkdown 대신 text 또는 정리된 html 받기
main_contentfalse을 설정해 메뉴까지 포함한 페이지 전체를 변환
render브라우저를 강제(true)하거나 금지(false); auto이 결정
include_links페이지의 링크를 별도 목록으로 받기
max_chars긴 페이지를 모델의 컨텍스트 예산에 맞게 자르기

read reference에 country, include_images, timeout을 포함한 모든 파라미터가 설명되어 있습니다.

남은 크레딧은 어떻게 확인하나요?

같은 키로 GET https://webreaderapi.com/api/v1/credits를 호출하세요. credits_remaining, credits_used_today, concurrency_limit을 반환하며 비용은 들지 않습니다. 긴 작업을 시작할 때 실행하면 작업이 중간에 402 insufficient_credits 오류로 실패하는 대신 깔끔하게 멈출 수 있습니다.

선불 크레딧은 만료되지 않습니다. 사용하지 않은 페이지는 사용할 때까지 계정에 남아 있습니다이므로, 한 프로젝트를 위해 구매한 팩은 다음 프로젝트에서도 가치를 유지합니다.

사이트에서 robots를 허용하지 않으면 어떻게 되나요?

해당 페이지는 읽지 않으며, 요금도 청구되지 않습니다. 저희 크롤러는 WebReaderAPI/1.0 (+https://webreaderapi.com/bot/)으로 자신을 알리고 사이트의 robots.txt를 따릅니다. 허용되지 않은 페이지는 403 blocked_by_robots를 반환하고, 다른 방식으로 요청을 거부하는 사이트는 사이트 자체의 상태 코드와 함께 502 target_refused를 반환합니다.

사이트가 우리 요청을 거부하면 그 응답을 그대로 반환합니다. 우리는 CAPTCHA를 풀거나, 계정에 로그인하거나, 차단이나 페이월을 우회하려 시도하지 않습니다. errors page에 어떤 오류를 재시도할 만하고 어떤 오류가 최종적인지 설명되어 있습니다.

다음은 어디로 가면 되나요?

빠른 시작: 자주 묻는 질문

설치할 SDK가 있나요?

없습니다. WebReaderAPI은 일반 HTTPS API라서 어떤 HTTP 클라이언트든 작동합니다. 문서에는 Python, Node.js, curl용 복사-붙여넣기 코드와 MCP, LangChain, LlamaIndex, OpenAI function calling용 도구 정의가 있습니다. 패키지로 배포되는 것은 없습니다.

헤더 대신 URL에 키를 넣어 보낼 수 있나요?

네, api_key 쿼리 파라미터로 가능합니다. Authorization: Bearer 헤더가 더 안전한데, URL은 흔히 로그와 브라우저 기록에 남기 때문입니다. 여러 API 키를 만들 수 있습니다. 예를 들어 에이전트나 프로젝트별로 하나씩 만들고, 대시보드에서 원하는 키를 폐기할 수 있습니다.

실패한 페이지도 크레딧을 쓰나요?

아니요. 1 크레딧 = 브라우저 없이 페이지 1회 읽기, 페이지가 JavaScript를 렌더링하는 데 브라우저가 필요하면 2 크레딧. 실패한 요청이나 사이트의 robots.txt가 거부한 요청은 과금되지 않습니다. 콘텐츠와 함께 반환된 페이지에만 요금이 청구됩니다.

구매 전에 사용해 볼 수 있나요?

무료 플랜은 없습니다. 무료 티어는 없습니다. 가장 작은 팩이 테스트하는 방법이며, 최소 충전 금액에서 결제합니다. 최소 금액에 도달하기 위해서만 추가한 금액은 사용하지 않은 상태에서 30일 이내에 요청 시 USDT 또는 USDC로 돌려보낼 수 있습니다.

US$0.07/1K 페이지부터 · KYC 없이

API 키 발급받기