MarkUDown
Autenticação — documentação da API de web scraping MarkUDown
Autenticação
Todas as requisições requerem uma API key no header.
Header
X-API-KEY: your-api-keyObtenha sua key no painel. Mantenha-a privada — nunca a exponha em código frontend.
Respostas de erro
| Status | Significado |
|---|---|
| 401 | API key ausente |
| 403 | Créditos insuficientes ou nenhum plano ativo (faça upgrade) |
| 429 | Limite de taxa excedido (limite do plano, ou 20 requisições/dia para chaves não cadastradas) |
| 402 | Assinatura suspensa por falha no pagamento — atualize a forma de pagamento |
Limites de requisições
Cada número é o máximo de requisições por minuto àquele endpoint, por chave de API. O minuto é o minuto do relógio em UTC, então a contagem zera no início de cada minuto. Acima do limite, a API responde 429. Só conta o POST que inicia a requisição — consultar GET /api/<endpoint>/{id} e listar ou excluir monitores não contam.
| Endpoint | Free | Basic | Intermediate | Professional |
|---|---|---|---|---|
| /api/scrape | 10 | 20 | 100 | 1000 |
| /api/crawl | 1 | 3 | 10 | 50 |
| /api/map | 10 | 10 | 20 | 100 |
| /api/extract | 3 | 10 | 20 | 100 |
| /api/create-schema | 10 | 10 | 20 | 100 |
| /api/prompt-extract | 3 | 10 | 20 | 100 |
| /api/batch-scrape | 1 | 3 | 10 | 50 |
| /api/search | 3 | 10 | 20 | 100 |
| /api/screenshot | 5 | 10 | 50 | 200 |
| /api/pdf-to-markdown | 5 | 10 | 50 | 200 |
| /api/rss | 5 | 10 | 20 | 100 |
| /api/change-detection | 3 | 10 | 20 | 100 |
| /api/deep-research | 1 | 3 | 5 | 20 |
| /api/agent | 1 | 3 | 10 | 30 |
| /api/smart-extract | 1 | 5 | 15 | 50 |
| /api/rank | 3 | 10 | 30 | 100 |
| /api/dataset | 1 | 3 | 10 | 30 |
| /api/monitor | 1 | 5 | 20 | 100 |
Chaves que não pertencem a uma conta usam os limites do Free, contados por IP do cliente, além do teto de 20 requisições/dia do nível gratuito.