Ir para o conteúdo
scrapa
IdiomaEnglishPortuguês

Sua primeira página

Uma chave, uma chamada. Toda requisição responde com o que custou e com o que sobrou, e uma página que você não recebeu não custa nada, a não ser que um script seu tenha rodado nela antes: aí só falha nossa continua de graça.

1 · Pegue uma chave

Crie uma conta e gere uma chave no console. Ela começa com sc_ e aparece uma única vez. Guarde como senha. O plano gratuito se renova todo mês e traz o produto inteiro: as duas engines, seu próprio proxy, MCP, e sem cartão.

console.scrapa.app

2 · Leia uma página

POST /v1/scrape
curl -X POST https://api.scrapa.app/v1/scrape \
  -H "authorization: Bearer sc_live_your_key" \
  -H "content-type: application/json" \
  -d '{"url": "https://example.com"}'

A resposta é a página em markdown, mais onde ela estava no fim, qual engine respondeu e quanto custou.

200 OK
{
  "data": {
    "url": "https://example.com",
    "finalUrl": "https://example.com/",
    "status": 200,
    "engine": "fetch",
    "pool": "residential",
    "bytes": 1256,
    "cached": false,
    "markdown": "# Example Domain\n\nThis domain is for use in…",
    "metadata": { "title": "Example Domain", "needsJs": false, … }
  },
  "meta": { "cost": 1, "creditsRemaining": 987, "requestId": "0f3c…" }
}

A forma GET é a mesma chamada, no formato de quem está no terminal.

GET /v1/scrape
curl "https://api.scrapa.app/v1/scrape?url=https://example.com&format=text,links" \
  -H "authorization: Bearer sc_live_your_key"

3 · Leia a resposta

formats
{
  "url": "https://example.com",
  "formats": ["markdown", "links", "screenshot"]
}

Peça mais de um formato na mesma chamada e pague a página uma vez só. markdown é o padrão, e html, text, links, screenshot e pdf são o resto.

markdown, text e extract trazem só o conteúdo principal da página, sem os menus, os anúncios e os links relacionados em volta. Mande onlyMainContent: false para receber a página inteira, ou escolha você mesmo as partes com seletores CSS em includeTags e excludeTags.

includeTags
{ "url": "https://shop.example.com/item/42", "includeTags": ["h1", ".price"] }

4 · Saiba quanto custou

Toda resposta medida carrega x-request-cost e x-credits-remaining, e os mesmos números em meta. Dá para consultar o preço antes de fazer a chamada no endpoint de quote. Esse é grátis.

Quanto custaria, sem fazer a chamada
curl -X POST https://api.scrapa.app/v1/scrape/quote \
  -H "authorization: Bearer sc_live_your_key" \
  -H "content-type: application/json" \
  -d '{"url": "https://example.com"}'

{"data":{"engine":"fetch","pool":"residential","formats":["markdown"],
         "cost":1,"maxCost":5,"freeMb":1,"perMb":10}}

Para onde ir agora