Authentication

All Messora API routes require authentication via the X-API-Key header.

Getting your API key

Create an account at www.messora.dev/auth/signup
Open API Keys in the logged-in area
Copy your key — it is shown once; store it securely

Using the API key

Include the X-API-Key header on every request:

curl -X POST https://api.messora.dev/scrape \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"url": "https://example.com", "formats": ["markdown"]}'

Authentication error responses

Status	Meaning
`401`	Missing `X-API-Key` header
`403`	Invalid or revoked API key

Credits

Each operation consumes credits from your monthly balance:

Operation	Cost
Scrape (markdown / raw)	1 credit per page
Scrape (structured JSON)	10 credits per request
Search	1 credit per returned result
Crawl	1 credit per successful page

Failures (anti-bot block, timeout, extraction error) do not consume credits.

Rate limits

Endpoint	Limit
`POST /scrape`	10 req/min
`POST /search`	2 req/min
`POST /crawl`	10 req/min
`GET /jobs/{job_id}`	No explicit limit (poll about every 2s)

When the limit is exceeded, the API returns 429 Too Many Requests. Wait for the cooldown before sending new requests.

Quickstart Scrape

⌘I

Getting started

Playground

Authentication

Authentication

Getting your API key

Using the API key

Authentication error responses

Credits

Rate limits

​Authentication

​Getting your API key

​Using the API key

​Authentication error responses

​Credits

​Rate limits

Authentication

Getting your API key

Using the API key

Authentication error responses

Credits

Rate limits