API di web scraping
Scraping sincrono
L’endpoint scrape avvia una sessione del browser, esegue JavaScript e restituisce HTML renderizzato in una singola richiesta sincrona.
POST
Scraping sincrono
Per iniziare
URL base
Esempio di richiesta
Opzioni di rendering
L’oggettorender controlla come il browser carica la pagina prima di catturare l’HTML. Tutti i campi sono opzionali — se omessi, si applicano i default del server.
Esempio per una pagina JavaScript-heavy che continua a recuperare dati dopo il caricamento:
Opzioni risorse
L’oggettoresources controlla quali tipi di asset il browser carica durante lo scraping. Bloccare risorse pesanti accelera le richieste quando servono solo testo e struttura HTML.
Tutti i campi sono opzionali. Se
resources è omesso, nessun tipo di risorsa viene bloccato, salvo default lato server nella deployment.
Esempio — scraping più veloce saltando immagini e font:
Parametri della richiesta
String
obbligatorio
L’URL di destinazione da scrapare. Deve essere un URL HTTP o HTTPS pubblico. Le richieste a localhost e IP privati sono bloccate dalla protezione SSRF.
String
obbligatorio
La tua chiave API univoca.
String
Identificatore di sessione opzionale per riutilizzare lo stato del browser (cookie, local storage) tra più richieste di scraping.
String
Preset dell’impronta del browser. Valori supportati:
desktop_en_us, desktop_ru_ru, mobile_en_us.Object
Opzioni di rendering per la sessione del browser.
String
Quando considerare completata la navigazione. Valori:
domcontentloaded, networkidle. Predefinito: domcontentloaded.Integer
Tempo massimo in millisecondi per attendere il caricamento della pagina. Predefinito: 60000.
Integer
Ritardo aggiuntivo in millisecondi dopo il caricamento prima di catturare i contenuti.
Boolean
Se
true, ignora gli errori del certificato TLS della pagina di destinazione.Object
Controlli sul caricamento delle risorse.
Array
Tipi di risorse da bloccare. Valori supportati:
images, fonts, media.Array
Elenco ordinato di azioni del browser da eseguire prima di catturare i contenuti. Ogni azione è un oggetto con un campo
type.String
obbligatorio
Tipo di azione. Valori supportati:
wait, wait_for, click, type, scroll.String
Selettore CSS per le azioni
wait_for, click o type.String
Testo da digitare per l’azione
type.String
Destinazione dello scroll per l’azione
scroll (es. bottom).Integer
Durata in millisecondi per l’azione
wait.Integer
Timeout in millisecondi per le azioni
wait_for.Array
Cookie da iniettare prima della navigazione. Ogni oggetto cookie richiede
name e value; campi opzionali: domain, path.Parametri della risposta
La risposta dell’API viene restituita in un formato JSON universale e leggero.Boolean
Indica se lo scraping è stato completato con successo.
String
L’HTML renderizzato della pagina.
Object
Metadati dello scraping, inclusi URL finale, codice di stato HTTP e durata.
Object
Dettagli dell’errore quando
ok è false.