GET /account/usage

{
  "breakdown": [
    {
      "credits_used": 15,
      "endpoint": "/scrape"
    },
    {
      "credits_used": 8,
      "endpoint": "/batch"
    }
  ],
  "credits_used": 23,
  "monthly_credits": 100,
  "plan": "free",
  "remaining_credits": 77
}

GET

account

usage

{
  "breakdown": [
    {
      "credits_used": 15,
      "endpoint": "/scrape"
    },
    {
      "credits_used": 8,
      "endpoint": "/batch"
    }
  ],
  "credits_used": 23,
  "monthly_credits": 100,
  "plan": "free",
  "remaining_credits": 77
}

Quando usar

Chame antes de um /batch ou /crawl grande para confirmar que há saldo, ou depois de uma execução para conciliar o que foi de fato cobrado. Todos os campos são da conta por trás da X-API-Key enviada — não existe seletor de conta.

Como ler os números

credits_used é a soma do consumo cobrado no mês-calendário corrente. Zera no dia 1º. remaining_credits é o saldo real, não monthly_credits - credits_used. Top-ups somam ao saldo sem alterar a franquia mensal, então os dois valores divergem assim que você compra créditos avulsos. breakdown agrupa o consumo do mês por endpoint, permitindo separar a cobrança de um /crawl da de um /scrape.

Rate limit

30 requisições por minuto, por conta. Este endpoint não serve para polling — use GET /jobs/{job_id} para acompanhar o progresso de um job.

Exemplo

cURL

curl https://api.messora.dev/account/usage \
  -H "X-API-Key: YOUR_API_KEY"

Relacionado

A tool MCP get_usage devolve os mesmos dados pelo protocolo MCP — veja Integração MCP.

Autorizações

X-API-Key

string

header

obrigatório

Resposta

Uso mensal da conta

Resposta de GET /account/usage (RF-010 / D-11).

breakdown

UsageBreakdownItem · object[]

obrigatório

Consumo do mês agrupado por endpoint.

Show child attributes

credits_used

integer

obrigatório

Soma dos créditos consumidos no mês-calendário corrente.

monthly_credits

integer

obrigatório

Franquia mensal do plano.

plan

string

obrigatório

Plano da conta: free, starter, growth ou scale.

remaining_credits

integer

obrigatório

Saldo disponível em accounts.balance. Inclui créditos de top-up, por isso não é necessariamente monthly_credits - credits_used.

​Quando usar

​Como ler os números

​Rate limit

​Exemplo

​Relacionado

Autorizações

Resposta

Quando usar

Como ler os números

Rate limit

Exemplo

Relacionado