Vai al contenuto principale
POST
Scraping sincrono

Per iniziare

URL base

Esempio di richiesta

Questa richiesta riuscita restituisce l’HTML renderizzato della pagina e i metadati:

Opzioni di rendering

L’oggetto render 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’oggetto resources 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.