Screenshot API

Una screenshot API è un servizio web che riceve un URL e le opzioni di cattura in una richiesta HTTP, carica la pagina in un browser sui propri server e restituisce il risultato come immagine o PDF. Permette a un'applicazione di richiedere screenshot dal codice senza installare o eseguire browser.

La maggior parte dei servizi autentica le richieste con una chiave API e addebita in base al numero di catture. Funzionalità, limiti e prezzi differiscono tra i fornitori e cambiano nel tempo, quindi confrontali nella documentazione di ciascun fornitore.

Come funzionano le screenshot API

1. Il client invia una richiesta con l'URL e le opzioni, come larghezza e altezza del viewport, area a pagina intera o viewport, fattore di scala del dispositivo, formato, ritardo e condizione di attesa.
2. Il servizio apre l'URL in un browser headless, spesso controllato con Playwright o Puppeteer.
3. Attende la pagina, applica opzioni come il nascondere banner dei cookie o annunci, e cattura.
4. Restituisce direttamente l'immagine, oppure la memorizza e restituisce un link.

Dove si usano le screenshot API

• Anteprime di link e schede social generate on demand.
• Miniature di URL inviati dagli utenti in directory o strumenti CMS.
• Copie archiviate di pagine per registrazioni.
• Verifiche pianificate che confrontano le pagine nel tempo.

API ospitata e self-hosted

Un'API ospitata elimina la manutenzione dei browser, la scalabilità e gli aggiornamenti. In cambio, URL e immagini passano per un terzo, e le pagine vengono caricate dalla rete e dalla regione del fornitore, il che può cambiare i contenuti dietro login, VPN o regole geografiche. Il self-hosting con Playwright o Puppeteer mantiene i dati nella tua infrastruttura, ma richiede di gestire browser, code e nuovi tentativi.

Errori comuni con le screenshot API

• Catturare pagine che richiedono un login senza passare i dati di sessione.
• Non impostare una condizione di attesa, che restituisce pagine caricate a metà.
• Inviare a un servizio di terze parti URL privati o interni.
• Ignorare i limiti di frequenza e i timeout nei job ad alto volume.

Ripeti gli stessi screenshot più volte?

Temposhot Website Capture carica gli URL che inserisci in browser locali gestiti sul tuo Mac e salva i file in locale. Funziona dall'app, non come servizio HTTP. Vedi automazione degli screenshot di siti web.

Domande frequenti

Per usare una screenshot API devo scrivere codice?

Sì, almeno una richiesta da uno script o da uno strumento di automazione.

Una screenshot API può catturare pagine dietro un login?

Alcune accettano cookie o header per questo. Verifica la documentazione del fornitore e i termini del sito.

Fonti

• Headless browser su Wikipedia
• Playwright screenshots guide

Risorse correlate

• Avvio rapido di Website Capture: cattura un elenco di URL in locale.
• Opzioni di Website Capture: condizioni di attesa e gestione dei banner dei cookie.
• Esecuzioni e risultati: nuovi tentativi e sessioni parziali.