Resposta rápida
Como converto uma URL em Markdown com uma API?
Envie a URL para GET https://webreaderapi.com/api/v1/read com sua chave de API no cabeçalho Authorization. WebReaderAPI busca a página, mantém o conteúdo principal e o retorna em Markdown com título, autor, data e contagem de palavras. Uma página custa um crédito (dois se precisar de navegador), a partir de US$ 0,07/1K páginas em outubro de 2026. Sem KYC; pague com cripto.
A API em uma tabela
| URL base | https://webreaderapi.com/api/v1 |
|---|---|
| Ler uma página | GET ou POST https://webreaderapi.com/api/v1/read |
| Várias URLs ou um site | POST https://webreaderapi.com/api/v1/batch e POST https://webreaderapi.com/api/v1/crawl, resultados de GET https://webreaderapi.com/api/v1/jobs/{job_id} |
| Créditos restantes | GET https://webreaderapi.com/api/v1/credits (grátis) |
| Autenticação | Envie sua chave de API no header Authorization como Bearer token, ou no parâmetro de consulta api_key |
| Cobrança | 1 crédito = 1 página lida sem navegador; 2 créditos quando a página precisa de um navegador para renderizar JavaScript. Uma requisição que falha, ou que o robots.txt de um site recusa, não é cobrada |
| Nosso rastreador (crawler) | WebReaderAPI/1.0 (+https://webreaderapi.com/bot/), token de robots.txt WebReaderAPI |
| Menor pacote | 10.000 páginas por US$ 3,75; os créditos nunca expiram |
Como obtenho uma chave de API?
Três passos, sem formulário para preencher. O mais lento é a confirmação na blockchain do seu depósito.
Recarregar com cripto
Envie pelo menos US$ 25 em BTC, USDT, USDC, ETH, SOL, LTC. Login pelo número da conta; e-mail é opcional.
Compre um pacote de créditos
10.000 páginas por US$ 3,75 já basta para testar todas as opções com suas próprias URLs.
Copie sua chave
Sua chave de API fica pronta no dashboard assim que sua recarga em cripto é confirmada e você compra um pack. Guarde-a em uma variável de ambiente chamada
WEBREADER_API_KEY.
Como é a primeira requisição?
É um GET HTTPS simples com o endereço da página no parâmetro url. Codifique o endereço, porque ele contém seus próprios caracteres : e /; o curl faz isso por você com --data-urlencode. As configurações padrão já atendem à maioria dos artigos e páginas de documentação: saída em Markdown, apenas o conteúdo principal e um navegador somente quando a página precisa de um.
curl -sG "https://webreaderapi.com/api/v1/read" \
-H "Authorization: Bearer $WEBREADER_API_KEY" \
--data-urlencode "url=https://example.com/blog/first-post"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"])
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));
O que vem de volta?
Um objeto JSON com o Markdown no campo markdown e os metadados da página ao lado: title, description, author, published_at, language, site_name e word_count. Dois campos ajudam você a conferir o que aconteceu: final_url é o endereço após os redirecionamentos, e rendered indica se um navegador foi necessário.
credits_used mostra quanto custou a chamada: 1 para uma página simples, 2 quando rendered é true, mais um se você escolheu um country. A página de formato de resposta lista todos os campos com um exemplo.
Quais opções vou usar mais?
Cinco parâmetros cobrem a maioria das necessidades. Todos são opcionais.
| Parâmetro | Use para |
|---|---|
format | Receber text ou html limpo em vez de markdown |
main_content | Definir false para converter a página inteira, menus incluídos |
render | Forçar (true) ou proibir (false) o navegador; auto decide |
include_links | Receber os links da página como uma lista separada |
max_chars | Cortar páginas longas para caber no orçamento de contexto de um modelo |
A referência de leitura descreve todos os parâmetros, incluindo country, include_images e timeout.
Como confiro meus créditos restantes?
Chame GET https://webreaderapi.com/api/v1/credits com a mesma chave. Ele retorna credits_remaining, credits_used_today e seu concurrency_limit, e não custa nada. Execute isso no início de um trabalho longo para que ele pare de forma limpa em vez de falhar por 402 insufficient_credits no meio do caminho.
Os créditos pré-pagos nunca expiram: as páginas não usadas ficam na sua conta até você usá-las, então um pack comprado para um projeto mantém seu valor para o próximo.
O que acontece se um site não permite robôs?
Não lemos a página, e você não é cobrado. Nosso crawler se identifica como WebReaderAPI/1.0 (+https://webreaderapi.com/bot/) e segue o robots.txt do site. Uma página não permitida retorna 403 blocked_by_robots; um site que recusa a requisição de outra forma retorna 502 target_refused com o próprio status code do site.
Se um site recusa nossa requisição, devolvemos a resposta dele: nunca resolvemos CAPTCHAs, nunca entramos em contas e nunca tentamos contornar um bloqueio ou um paywall. A página de erros explica quais erros vale a pena tentar de novo e quais são definitivos.
Para onde vou agora?
- Ler a referência do endpoint Todos os parâmetros do /read, com exemplos
- Lote e rastreamento (crawl) Até 100 URLs por lote, ou um site inteiro
- Formato da resposta Todos os campos da resposta
- Erros e robots.txt Códigos, causas e regras de retry
- Python requests, async httpx, chunking para RAG
- Node.js fetch, um pequeno pool, polling de crawl
- curl e jq Receitas para o terminal
- servidor MCP Uma ferramenta read_url para Claude e Cursor
- LangChain e LlamaIndex Loaders e ferramentas para RAG
- chamada de função da OpenAI Um schema e loop de ferramenta read_url
- n8n Ferramenta HTTP Request para um AI Agent
- OpenClaw Adicionar o servidor MCP ao lado do web_fetch
Início rápido: perguntas comuns
Existe um SDK para instalar?
Não. WebReaderAPI é uma API HTTPS simples, então qualquer cliente HTTP funciona. A documentação traz código para copiar e colar em Python, Node.js e curl, e definições de ferramentas para MCP, LangChain, LlamaIndex e OpenAI function calling. Nada é publicado como pacote.
Posso enviar a chave na URL em vez de no header?
Sim, como o parâmetro de consulta api_key. O header Authorization: Bearer é mais seguro, porque URLs muitas vezes acabam em logs e no histórico do navegador. Crie várias chaves de API, por exemplo uma por agente ou projeto, e revogue qualquer uma delas no seu dashboard.
Uma página com falha consome um crédito?
Não. 1 crédito = 1 página lida sem navegador; 2 créditos quando a página precisa de um navegador para renderizar JavaScript. Uma requisição que falha, ou que o robots.txt de um site recusa, não é cobrada. Só é cobrada a página que retorna com conteúdo.
Posso testar antes de comprar?
Não há plano gratuito. Não há plano gratuito: o menor pack é a forma de testar, pago a partir da recarga mínima, e o valor adicionado apenas para atingir essa recarga mínima pode ser devolvido sob solicitação em até 30 dias, em USDT ou USDC, enquanto não for gasto.