Không cần KYC — không ID, không selfie, không giấy tờ. Thanh toán bằng crypto: BTC, USDT, USDC, ETH, SOL, LTC
Ngôn ngữ: Tiếng Việt
Lấy khóa API

Tài liệu · bắt đầu nhanh

Bắt đầu nhanh với URL to Markdown API: trang đầu tiên của bạn trong hai phút

Một endpoint, một tham số: gửi một URL đến /read và nhận nội dung chính của trang về dưới dạng Markdown. Trang này đưa bạn từ số dư trống đến một lệnh gọi chạy được, rồi chỉ tới mọi thứ khác.

Cập nhật lần cuối: · 6 phút đọc

Câu trả lời nhanh

Làm sao để chuyển một URL sang Markdown bằng API?

Gửi URL đến GET https://webreaderapi.com/api/v1/read với khóa API của bạn trong header Authorization. WebReaderAPI tải trang, giữ lại nội dung chính và trả về dưới dạng Markdown kèm tiêu đề, tác giả, ngày và số từ. Mỗi trang tốn một credit (hai nếu cần trình duyệt), từ 0,07 US$/1K trang tính đến tháng 10 năm 2026. Không cần KYC; thanh toán bằng crypto.

API trong một bảng

Base URLhttps://webreaderapi.com/api/v1
Đọc một trangGET hoặc POST https://webreaderapi.com/api/v1/read
Nhiều URL hoặc một trang webPOST https://webreaderapi.com/api/v1/batch và POST https://webreaderapi.com/api/v1/crawl, kết quả từ GET https://webreaderapi.com/api/v1/jobs/{job_id}
Credit còn lạiGET https://webreaderapi.com/api/v1/credits (miễn phí)
Xác thựcGửi khóa API trong header Authorization dưới dạng Bearer token, hoặc trong query parameter api_key
Tính phí1 credit = đọc 1 trang không cần trình duyệt; 2 credit khi trang cần trình duyệt để render JavaScript. Yêu cầu thất bại, hoặc bị robots.txt của trang web từ chối, không bị tính phí
Trình thu thập của chúng tôiWebReaderAPI/1.0 (+https://webreaderapi.com/bot/), robots.txt token WebReaderAPI
Pack nhỏ nhất10.000 trang cho 3,75 US$; credit không bao giờ hết hạn

Làm sao để lấy một khóa API?

Ba bước, không cần điền form. Bước chậm nhất là xác nhận blockchain cho khoản nạp của bạn.

  1. Nạp bằng crypto

    Gửi tối thiểu 25 US$ bằng BTC, USDT, USDC, ETH, SOL, LTC. Đăng nhập bằng số tài khoản; email là tùy chọn.

  2. Mua một gói credit

    10.000 trang cho 3,75 US$ là đủ để thử mọi tùy chọn trên URL của riêng bạn.

  3. Sao chép khóa của bạn

    Khóa API của bạn sẵn sàng trong dashboard sau khi khoản nạp crypto được xác nhận và bạn đã mua một pack. Lưu nó trong biến môi trường tên là WEBREADER_API_KEY.

Request đầu tiên trông như thế nào?

Đó là một HTTPS GET thông thường với địa chỉ trang nằm trong tham số url. Hãy encode địa chỉ, vì nó chứa các ký tự : và / của chính nó; curl làm việc đó cho bạn với --data-urlencode. Các thiết lập mặc định đã phù hợp với hầu hết bài viết và trang tài liệu: đầu ra Markdown, chỉ nội dung chính, và chỉ dùng trình duyệt headless khi trang cần.

curl: đọc một trang
curl -sG "https://webreaderapi.com/api/v1/read" \
  -H "Authorization: Bearer $WEBREADER_API_KEY" \
  --data-urlencode "url=https://example.com/blog/first-post"
Python: đọc một trang và lưu lại
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+: đọc một trang
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));

Kết quả trả về là gì?

Một đối tượng JSON với Markdown trong trường markdown và metadata của trang bên cạnh: title, description, author, published_at, language, site_name và word_count. Hai trường giúp bạn kiểm tra chuyện gì đã xảy ra: final_url là địa chỉ sau các lần redirect, và rendered cho bạn biết có cần đến trình duyệt headless hay không.

credits_used cho thấy chi phí của lần gọi: 1 cho một trang thường, 2 khi rendered là true, thêm một nếu bạn chọn country. Trang định dạng phản hồi liệt kê mọi trường kèm ví dụ.

Tôi sẽ dùng những tùy chọn nào nhiều nhất?

Năm tham số đáp ứng hầu hết nhu cầu. Tất cả đều tùy chọn.

Tham sốDùng để
formatNhận text hoặc html đã làm sạch thay vì markdown
main_contentĐặt false để chuyển toàn bộ trang, kể cả menu
renderBuộc (true) hoặc cấm (false) trình duyệt headless; auto quyết định
include_linksNhận các liên kết của trang thành một danh sách riêng
max_charsCắt các trang dài để vừa ngân sách ngữ cảnh của model

Tham chiếu read mô tả mọi tham số, gồm cả country, include_images và timeout.

Làm sao kiểm tra credit còn lại?

Gọi GET https://webreaderapi.com/api/v1/credits với cùng khóa đó. Nó trả về credits_remaining, credits_used_today và concurrency_limit của bạn, và không tốn gì. Hãy chạy nó ở đầu một tác vụ dài để tác vụ dừng gọn gàng thay vì thất bại vì 402 insufficient_credits giữa chừng.

Credit trả trước không bao giờ hết hạn: số trang chưa dùng vẫn ở trong tài khoản của bạn cho đến khi bạn dùng, nên một pack mua cho dự án này vẫn giữ nguyên giá trị cho dự án tiếp theo.

Chuyện gì xảy ra nếu một trang web không cho phép robots?

Chúng tôi không đọc trang, và bạn không bị tính phí. Trình thu thập dữ liệu của chúng tôi tự giới thiệu là WebReaderAPI/1.0 (+https://webreaderapi.com/bot/) và tuân theo robots.txt của trang web. Một trang bị disallow trả về 403 blocked_by_robots; một trang web từ chối request theo cách khác trả về 502 target_refused kèm mã trạng thái của chính trang đó.

Nếu một website từ chối yêu cầu của chúng tôi, chúng tôi trả lại câu trả lời của trang đó: chúng tôi không bao giờ giải CAPTCHA, đăng nhập vào tài khoản, hay tìm cách vượt qua chặn hoặc paywall. Trang lỗi giải thích lỗi nào nên thử lại và lỗi nào là lỗi cuối cùng.

Tôi nên đi đâu tiếp theo?

Bắt đầu nhanh: câu hỏi thường gặp

Có SDK nào cần cài không?

Không. WebReaderAPI là một API HTTPS thông thường, nên HTTP client nào cũng dùng được. Tài liệu có mã copy-paste cho Python, Node.js và curl, cùng định nghĩa tool cho MCP, LangChain, LlamaIndex và OpenAI function calling. Không có gì được phát hành dưới dạng package.

Tôi có thể gửi khóa trong URL thay vì header không?

Được, dưới dạng tham số truy vấn api_key. Header Authorization: Bearer an toàn hơn, vì URL thường lọt vào log và lịch sử trình duyệt. Tạo nhiều khóa API, ví dụ mỗi agent hoặc dự án một khóa, và thu hồi bất kỳ khóa nào từ dashboard của bạn.

Một trang thất bại có tốn credit không?

Không. 1 credit = đọc 1 trang không cần trình duyệt; 2 credit khi trang cần trình duyệt để render JavaScript. Yêu cầu thất bại, hoặc bị robots.txt của trang web từ chối, không bị tính phí. Chỉ trang trả về có nội dung mới bị tính phí.

Tôi có thể dùng thử trước khi mua không?

Không có gói miễn phí. Không có gói miễn phí: pack nhỏ nhất là cách để thử, thanh toán từ mức nạp tối thiểu, và phần tiền chỉ nạp thêm để đạt mức tối thiểu đó có thể được gửi trả theo yêu cầu trong vòng 30 ngày, bằng USDT hoặc USDC, miễn là chưa dùng.

Từ 0,07 US$/1K trang · không cần KYC

Lấy khóa API