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-key

Get your key from the dashboard. Keep it private — never expose it in frontend code.

Error responses

StatusMeaning
401Missing API key
403Not enough credits or no active plan (upgrade required)
429Rate limit exceeded (plan limit, or 20 requests/day for unregistered keys)
402Subscription 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.

EndpointFreeBasicIntermediateProfessional
/api/scrape10201001000
/api/crawl131050
/api/map101020100
/api/extract31020100
/api/create-schema101020100
/api/prompt-extract31020100
/api/batch-scrape131050
/api/search31020100
/api/screenshot51050200
/api/pdf-to-markdown51050200
/api/rss51020100
/api/change-detection31020100
/api/deep-research13520
/api/agent131030
/api/smart-extract151550
/api/rank31030100
/api/dataset131030
/api/monitor1520100

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.