Extraia dados estruturados de qualquer site
Escolha os campos de que você precisa. Receba tudo de volta como JSON limpo.


# Mouse sem fio — Modelo X**$49.00** · Em estoque · 4.6 (1,284 avaliações)Receptor de 2.4 GHz de baixa-latency, bateria de 70-daye switches silenciosos.| Spec | Value || --------- | ------------ || Conexão | 2.4 GHz, BT5 || Bateria | 70 dias |Sem menus, rodapés e anúncios: de 3% a 24% dos tokens do HTML bruto. Página de exemplo.
A resposta completa: status, URL, engine e dados. Página de exemplo.
Informações da página, regras CSS ou um JSON Schema com seletores. Página de exemplo.
Passos a executar na página, em renderização de navegador completo.
Como funciona
- Dê nome aos seus campos e dê um seletor CSS a cada um.
- Envie-os em
extractcom a URL da página. - Leia o JSON. Seus campos ficam em
data.
curl https://api.spicrawl.com/v1/scrape \
-H "Authorization: Bearer $SPICRAWL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/products/42",
"extract": { "title": "h1", "price": ".price", "next_page": "a.next@href" }
}'import os, requests
r = requests.post(
"https://api.spicrawl.com/v1/scrape",
headers={"Authorization": f"Bearer {os.environ['SPICRAWL_API_KEY']}"},
json={
"url": "https://example.com/products/42",
"extract": {"title": "h1", "price": ".price", "next_page": "a.next@href"},
},
timeout=120,
)
env = r.json()
print(env["data"], env.get("empty_fields"))spicrawl scrape https://example.com/products/42 \
--extract '{"title":"h1","price":".price","next_page":"a.next@href"}'{
"status": 200,
"data": {
"title": "Walnut Desk",
"price": "$349.00"
},
"empty_fields": ["next_page"]
}empty_fields lista os campos que não encontraram nada. Costuma ser o primeiro sinal de que um site mudou o layout.
Três formas de obter dados
| Way | O que você envia | O que você recebe |
|---|---|---|
autoparse | "autoparse": true | O JSON-LD, OpenGraph, microdata, metadados e estado do app da própria página |
| Mapa de seletores | Nomes de campos e seletores CSS | Exatamente esses campos, como texto |
| JSON Schema | Um schema cujos campos têm seletores | Valores tipados e verificados, então "$1,234.56" vira 1234.56 |
Bom saber
- Sem créditos extras para extração. Você paga só pela requisição: 1 crédito simples, 3 com JavaScript.
- Em breve: extração a partir de um prompt em linguagem natural. Hoje, use seletores, um schema ou autoparse.
- Não em batch. A extração roda só em scrapes individuais.
- Sua responsabilidade: extraia só dados que você tem o direito de usar. Veja nossos termos.
Perguntas frequentes
Como extraio dados de um site como JSON?
Envie extract com um mapa de nomes de campos para seletores CSS, como "title": "h1" e "price": ".price". Os valores voltam em data na resposta JSON.
O que o autoparse faz?
Ele retorna o que a página já diz sobre si mesma, sem seletores: JSON-LD, OpenGraph, Twitter Card, microdata, RDFa, metadados do head e estado embutido do app.
Ele pode retornar números em vez de texto?
Sim. Use um JSON Schema cujas propriedades tenham um seletor. Os valores são convertidos para o tipo declarado, então "$1,234.56" vira 1234.56, e o resultado é verificado contra o schema.
Como sei quando um site muda o layout?
Verifique empty_fields na resposta. Ele lista os campos cujo seletor não encontrou nada, o que costuma ser o primeiro sinal de que a marcação mudou.
Posso descrever os campos em palavras simples em vez de seletores?
Ainda não. A extração com um prompt de modelo está em breve. Hoje, use seletores, um JSON Schema ou autoparse.