MarkUDown
Authentication — MarkUDown web scraping API docs
Authentication
All requests require an API key passed in the request header.
Header
X-API-KEY: your-api-keyGet your key from the dashboard. Keep it private — never expose it in frontend code.
Error responses
| Status | Meaning |
|---|---|
| 401 | Missing API key |
| 403 | Not enough credits or no active plan (upgrade required) |
| 429 | Rate limit exceeded (plan limit, or 20 requests/day for unregistered keys) |
| 402 | Subscription suspended after a failed payment — update your payment method |
Rate limits
Each number is the maximum requests per minute to that endpoint, per API key. The minute is the current UTC clock minute, so the count resets at the start of every minute. Over the limit, the API answers 429. Only the POST that starts a request counts — polling GET /api/<endpoint>/{id} and listing or deleting monitors do not.
| 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 |
Keys that are not registered to an account get the Free limits counted per client IP, on top of the 20 requests/day free-tier cap.