Estrai dati strutturati da qualsiasi sito web
Scegli i campi che ti servono. Ricevili come JSON pulito.


# Wireless Mouse — Model X**$49.00** · Disponibile · 4.6 (1.284 recensioni)Ricevitore da 2.4 GHz a bassa-latency, autonomia di 70-daye switch silenziosi.| Spec | Value || --------- | ------------ || Connessione| 2.4 GHz, BT5 || Batteria | 70 giorni |Senza menu, footer e pubblicità: dal 3% al 24% dei token dell’HTML grezzo. Pagina di esempio.
La risposta completa: stato, URL, motore e dati. Pagina di esempio.
Info sulla pagina, regole CSS o un JSON Schema con selettori. Pagina di esempio.
Passaggi da eseguire sulla pagina, con il rendering con browser completo.
Come funziona
- Dai un nome ai tuoi campi e assegna a ciascuno un selettore CSS.
- Inviali in
extractcon l’URL della pagina. - Leggi il JSON. I tuoi campi sono sotto
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 elenca i campi che non hanno trovato nulla. Spesso è il primo segnale che un sito ha cambiato layout.
Tre modi per ottenere i dati
| Modo | Cosa invii | Cosa ottieni |
|---|---|---|
autoparse | "autoparse": true | JSON-LD, OpenGraph, microdata, metadati e stato dell’app della pagina stessa |
| Mappa dei selettori | Nomi dei campi e selettori CSS | Esattamente quei campi, come testo |
| JSON Schema | Uno schema in cui i campi hanno dei selettori | Valori tipizzati e controllati, così "$1,234.56" diventa 1234.56 |
Da sapere
- Nessun credito extra per l’estrazione. Paghi solo la richiesta: 1 credito semplice, 3 con JavaScript.
- In arrivo: estrazione da un prompt in linguaggio naturale. Oggi usa selettori, uno schema o autoparse.
- Non nei batch. L’estrazione funziona solo sugli scrape singoli.
- La tua responsabilità: estrai solo dati che hai il diritto di usare. Vedi i nostri termini.
Domande frequenti
Come estraggo i dati da un sito web come JSON?
Invia extract con una mappa di nomi di campo e selettori CSS, come "title": "h1" e "price": ".price". I valori tornano sotto data nella risposta JSON.
Cosa fa autoparse?
Restituisce ciò che la pagina dice già di sé, senza selettori: JSON-LD, OpenGraph, Twitter Card, microdata, RDFa, metadati dell’head e stato dell’app incorporato.
Può restituire numeri invece di testo?
Sì. Usa un JSON Schema le cui proprietà hanno un selettore. I valori vengono convertiti nel tipo dichiarato, così "$1,234.56" diventa 1234.56, e il risultato viene verificato rispetto allo schema.
Come so quando un sito cambia il suo layout?
Controlla empty_fields nella risposta. Elenca i campi il cui selettore non ha trovato nulla, spesso il primo segnale che il markup è cambiato.
Posso descrivere i campi a parole invece che con i selettori?
Non ancora. L’estrazione con un prompt al modello è in arrivo. Oggi usa selettori, un JSON Schema o autoparse.