Skip to main content
POST
Screenshot sincrono

Per iniziare

URL base

Esempio di richiesta

Una richiesta riuscita restituisce lo screenshot in base64 e metadati:
Decodifica image_base64 per ottenere i byte JPEG o PNG grezzi.

Opzioni di rendering

L’oggetto render controlla come il browser carica la pagina prima della cattura. Tutti i campi sono opzionali — se omessi, si applicano i valori predefiniti del server.

Campi di convenienza

Questi campi di livello superiore sono alias uniti in render e actions per retrocompatibilità e richieste più semplici: Esempio con campi piatti:

Opzioni risorse

L’oggetto resources controlla quali tipi di risorse il browser carica durante la cattura. Bloccare risorse pesanti accelera le richieste quando la fedeltà visiva lo consente.

Endpoint GET legacy

GET /v1/ restituisce byte immagine grezzi (JPEG o PNG) invece di JSON. Passa i parametri come query string:
Parametri query supportati: url, api_key, session_id, fingerprint, capture_full_page, width, height, delay, css_injection, user_agent, export_format.

Parametri di richiesta

String
obbligatorio
L’URL di destinazione da catturare. Deve essere un URL HTTP o HTTPS pubblico. Le richieste a localhost e indirizzi 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.
String
Preset dell’impronta del browser. Valori supportati: desktop_en_us, desktop_ru_ru, mobile_en_us.
Object
Opzioni di rendering e cattura per la sessione del browser.
String
Quando considerare la navigazione completata. Valori: domcontentloaded, networkidle. Predefinito: domcontentloaded.
Integer
Tempo massimo in millisecondi di attesa del caricamento della pagina. Predefinito: 60000.
Integer
Ritardo aggiuntivo in millisecondi dopo l’evento di caricamento della pagina prima della cattura.
Boolean
Se true, ignora errori del certificato TLS della pagina di destinazione.
Boolean
Se true, cattura l’intera pagina scrollabile. Predefinito: true.
String
Formato di output: jpeg o png. Predefinito: jpeg.
String
User-Agent personalizzato per la sessione del browser.
Object
Dimensione del viewport con width e height in pixel.
Object
Controlli di caricamento delle risorse.
Array
Tipi di risorse da bloccare. Valori supportati: images, fonts, media.
Array
Elenco ordinato di azioni del browser prima della cattura. Ogni azione è un oggetto con un campo type.
String
obbligatorio
Tipo di azione. Valori supportati: wait, wait_for, click, type, scroll, inject_css.
String
Selettore CSS per azioni wait_for, click o type.
String
Testo da digitare per l’azione type.
String
Stringa CSS per l’azione inject_css.
String
Destinazione dello scroll per l’azione scroll (es. bottom).
Integer
Durata in millisecondi per l’azione wait.
Array
Cookie da iniettare prima della navigazione. Ogni oggetto cookie richiede name e value; campi opzionali: domain, path.
Boolean
Alias di convenienza per render.full_page.
Integer
Alias di convenienza per render.viewport.width.
Integer
Alias di convenienza per render.viewport.height.
Integer
Ritardo in secondi prima della cattura. Mappato a render.post_load_wait_ms.
String
CSS iniettato tramite un’azione inject_css quando non è già presente in actions.
String
Alias di convenienza per render.screenshot_format. Valori: jpeg, png.

Parametri di risposta

La risposta dell’API viene restituita in un formato JSON universale e leggero.
Boolean
Se lo screenshot è stato completato con successo.
String
Dati immagine codificati in base64. Decodifica per ottenere byte JPEG o PNG grezzi.
String
Tipo MIME dell’immagine (image/jpeg o image/png).
Object
Metadati sulla cattura, incluso il tempo trascorso in millisecondi.
Object
Dettagli dell’errore quando ok è false.