Scrape

O endpoint POST /scrape executa scraping síncrono em uma URL e retorna o conteúdo nos formatos solicitados. O motor anti-bot nativo do Messora evade proteções automaticamente.

Endpoint

POST /scrape

Autenticação

Header X-API-Key obrigatório. Veja Autenticação.

Parâmetros

string

obrigatório

URL pública a ser raspada. URLs internas (RFC1918, loopback, metadata cloud) são rejeitadas pelo SSRF guard.

string[]

padrão:"[\"markdown\"]"

Formatos de saída desejados. Valores aceitos: markdown, json, raw.

object

Schema JSON para extração estruturada. Obrigatório quando formats inclui json.

string

Prompt de contexto para guiar a extração estruturada (usado junto com json_schema).

boolean

padrão:"false"

Se true, renderiza JavaScript antes da extração (headless browser).

boolean

padrão:"false"

Se true, extrai apenas o conteúdo principal da página, removendo navegação, rodapés e sidebars.

integer

padrão:"60"

Tempo máximo de espera em segundos (1–180).

integer

Tempo adicional em milissegundos para aguardar após o carregamento (útil com render_js).

integer

padrão:"1"

Máximo de páginas extraídas em uma única chamada (1–50). Multiplica o custo: markdown/raw cobram 1 crédito por página, então max_pages: 50 custa até 50 créditos. Ignorado quando formats inclui json (10 créditos fixos).

string[]

Tags de atribuição para o registro de uso (até 10 tags).

A lista completa de parâmetros — incluindo fact_check, max_age_ms, max_depth, follow_subdomains, include_frames e parse_pdf — é gerada a partir do schema na página de referência POST /scrape.

Custo

Formato	Créditos
`markdown` ou `raw`	1 crédito × `max_pages` (padrão: 1)
`json` (extração estruturada)	10 créditos por request

Falhas (blocked_antibot, timeout, extraction_failed) não consomem créditos.

Exemplo

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

import requests

response = requests.post(
    "https://api.messora.dev/scrape",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": "YOUR_API_KEY",
    },
    json={
        "url": "https://messora.dev",
        "formats": ["markdown"],
        "only_main_content": True,
    },
)

data = response.json()
print(data["markdown"])

const response = await fetch("https://api.messora.dev/scrape", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    url: "https://messora.dev",
    formats: ["markdown"],
    only_main_content: true,
  }),
});

const data = await response.json();
console.log(data.markdown);

Resposta de sucesso

{
  "success": true,
  "scrape_status": "success",
  "markdown": "# Messora\n\nThis domain is for use in illustrative examples...",
  "credits_used": 1,
  "remaining_credits": 99
}

Extração estruturada (JSON)

Para extrair dados estruturados, inclua json nos formats e forneça um json_schema:

curl -X POST https://api.messora.dev/scrape \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "url": "https://messora.dev",
    "formats": ["json"],
    "json_schema": {
      "type": "object",
      "properties": {
        "titulo": {"type": "string"},
        "preco": {"type": "number"},
        "disponivel": {"type": "boolean"}
      },
      "required": ["titulo", "preco"]
    }
  }'

Extração estruturada consome 10 créditos por request. Uma execução que falha (blocked_antibot, timeout, extraction_failed) estorna os 10.

Status da resposta

`scrape_status`	Significado	Créditos cobrados
`success`	Conteúdo extraído com sucesso	Sim
`blocked_antibot`	Alvo bloqueou a extração	Não
`timeout`	Tempo limite excedido	Não
`extraction_failed`	Falha na extração do conteúdo	Não

Erros

HTTP Status	Descrição
`401`	`X-API-Key` ausente
`403`	API key inválida ou revogada
`422`	URL interna (SSRF), parâmetros inválidos, ou `json_schema` ausente com formato `json`
`429`	Rate limit excedido (10 req/min)

Início

Integrações

Playground

Scrape

Scrape

Endpoint

Autenticação

Parâmetros

Custo

Exemplo

Resposta de sucesso

Extração estruturada (JSON)

Status da resposta

Erros

​Scrape

​Endpoint

​Autenticação

​Parâmetros

​Custo

​Exemplo

​Resposta de sucesso

​Extração estruturada (JSON)

​Status da resposta

​Erros

Scrape

Endpoint

Autenticação

Parâmetros

Custo

Exemplo

Resposta de sucesso

Extração estruturada (JSON)

Status da resposta

Erros