Autenticação

Todas as rotas da API Messora exigem autenticação via header X-API-Key.

Obtendo sua API key

Crie uma conta em www.messora.dev/auth/signup
Acesse API Keys na área logada
Copie sua chave — ela aparece uma vez; guarde-a em local seguro

Usando a API key

Inclua o header X-API-Key em toda requisição:

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"]}'

Respostas de erro de autenticação

Status	Significado
`401`	Header `X-API-Key` ausente
`403`	API key inválida ou revogada

Créditos

Cada operação consome créditos do saldo mensal da conta:

Operação	Custo
Scrape (markdown / raw)	1 crédito por página
Scrape (JSON estruturado)	10 créditos por request
Search	1 crédito por resultado retornado
Crawl	1 crédito por página bem-sucedida

Falhas (bloqueio anti-bot, timeout, erro de extração) não consomem créditos.

Rate limits

Endpoint	Limite
`POST /scrape`	10 req/min
`POST /search`	2 req/min
`POST /crawl`	10 req/min
`GET /jobs/{job_id}`	Sem limite explícito (polling recomendado a cada 2s)

Quando o limite é excedido, a API retorna 429 Too Many Requests. Aguarde o período de cooldown antes de enviar novas requisições.

Quickstart Scrape

⌘I

Início

Playground

Autenticação

Autenticação

Obtendo sua API key

Usando a API key

Respostas de erro de autenticação

Créditos

Rate limits

​Autenticação

​Obtendo sua API key

​Usando a API key

​Respostas de erro de autenticação

​Créditos

​Rate limits

Autenticação

Obtendo sua API key

Usando a API key

Respostas de erro de autenticação

Créditos

Rate limits