API screenshot di siti web
Screenshot sincrono
L’endpoint screenshot esegue una sessione del browser, esegue JavaScript e restituisce un’immagine codificata in base64 in una singola richiesta sincrona.
POST
Screenshot sincrono
Per iniziare
URL base
Esempio di richiesta
image_base64 per ottenere i byte JPEG o PNG grezzi.
Opzioni di rendering
L’oggettorender 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 inrender e actions per retrocompatibilità e richieste più semplici:
Esempio con campi piatti:
Opzioni risorse
L’oggettoresources 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:
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.Screenshot sincrono