Intelligence su domini e web 4 Endpoint 6 Caratteristiche Principali

API per Recupera pagine web con prezzo prevedibile per URL

Invia un URL, scegli quanto sforzo di recupero ha bisogno e ricevi la risposta della pagina attraverso un'API. Usa richieste leggere per pagine semplici, modalità resilienti quando un nuovo tentativo potrebbe aiutare, o rendering del browser per contenuti guidati da JavaScript.

Categoria Intelligence su domini e web
Endpoint 4
Caratteristiche Principali 6
Domande Frequenti 8

Utilizzato da persone di aziende straordinarie

VercelLLM PulseOLXCasa ModernaPipeCal.comBeehiivSnykTogglRemoteSprigDeel

Segnali di fiducia prima dell’integrazione

Documentazione trasparente, richieste autenticate e dettagli di affidabilità visibili rendono più semplice valutare DomScan prima del rilascio.

In tempo reale Stato del servizio

Controlla lo stato del servizio in tempo reale e le risposte di errore documentate prima dell’integrazione.

OpenAPI Artefatti API

OpenAPI, Swagger, Postman, CLI, SDK e link MCP sono a un clic.

Chiavi API Accesso protetto

Gli endpoint autenticati usano chiavi API con costi in crediti chiari prima della chiamata.

10,000 Quota gratuita

Inizia con 10.000 crediti mensili e fai upgrade solo quando l’uso cresce.

Cosa ti aiuta a costruire questa API

Usa questa pagina come brief di produzione: endpoint, esempi, forma della risposta e parti del workflow per integrare DomScan nel tuo prodotto.

Workflow di prodotto

Integra controlli dominio, intelligence DNS, segnali di rischio o arricchimento in onboarding, ricerca e strumenti interni.

Automazione per analisti

Sostituisci lookup manuali ripetuti con job pianificati, alert e passaggi di indagine riproducibili.

Dati JSON puliti

Usa campi prevedibili, codici di stato documentati e costi in crediti invece di fare scraping di pagine provider.

AI e strumenti ops

Alimenta agenti, dashboard, playbook SOAR e CRM tramite OpenAPI, SDK, Postman o MCP.

Workflow di integrazione

Un percorso semplice dalla prima richiesta all’uso ripetibile in produzione.

1
Autentica una volta

Invia la tua chiave API con l’header documentato e mantieni richieste coerenti tra servizi.

2
Interroga con esempi

Parti dagli esempi curl e HTTP, poi mappa i parametri nel codice della tua applicazione.

3
Opera e monitora

Usa codici di stato, costi in crediti e campi di risposta per costruire retry, log e alert.

Kit sviluppatori

Passa da questa pagina a docs leggibili da macchina, raccolte di richieste, SDK o strumenti per agenti.

Mappa di parametri e risposta

Controlla input, campi di output e codici di stato prima di collegare l’endpoint al tuo client.

Parametri richiesta

Parametro

urlmodeoutputurlsjob_idlimitoffset
Campi risposta

Risposta di esempio

datadata.urldata.final_urldata.statusdata.outcomedata.content_typedata.contentdata.bytesdata.truncateddata.redirect_countdata.attempt_countdata.duration_ms
Copertura stati

Codici di stato HTTP

200202400401402403409429503

Endpoint

POST /v1/scrape
Crediti: 1-20/itemAutenticazione: Autenticazione richiesta
urlmodeoutput
POST /v1/scrape/jobs
Crediti: 1-20/itemAutenticazione: Autenticazione richiesta
modeoutputurls
GET /v1/scrape/jobs/:job_id
Crediti: 0Autenticazione: Autenticazione richiesta
job_id
GET /v1/scrape/jobs/:job_id/results
Crediti: 0Autenticazione: Autenticazione richiesta
job_idlimitoffset

Scegli lo sforzo di recupero per ogni URL

I crediti si basano sulla modalità che richiedi, non sullo stato HTTP o sul contenuto restituito dal sito web di destinazione.

Standard

1 credito per URL

Un tentativo di recupero standard per pagine semplici.

Resiliente

2 crediti per URL

Un tentativo standard con un nuovo tentativo quando il risultato soddisfa le condizioni di nuovo tentativo documentate.

Renderizzato

10 crediti per URL

Un tentativo renderizzato dal browser per pagine che richiedono l'esecuzione di JavaScript.

Renderizzato resiliente

20 crediti per URL

Un tentativo renderizzato dal browser con un nuovo tentativo quando il risultato soddisfa le condizioni di nuovo tentativo documentate.

Le modalità resilienti costano l'importo elencato anche quando il primo tentativo ha successo. Includono un nuovo tentativo idoneo, non nuovi tentativi illimitati o una garanzia che il sito web di destinazione restituirà il contenuto che ti aspetti.

La fatturazione riflette il lavoro richiesto

Un'operazione API riuscita significa che DomScan ha eseguito la modalità di recupero selezionata e restituito il risultato del sito di destinazione.

Il risultato potrebbe comunque essere un reindirizzamento, un errore HTTP, una risposta bloccata, una pagina di sfida, una pagina vuota o contenuto che non soddisfa le tue esigenze. Questi risultati del sito di destinazione sono addebitabili e non sono idonei per un rimborso di credito.

Un rimborso è disponibile solo quando DomScan verifica che la sua stessa piattaforma non ha eseguito la modalità di recupero selezionata.

Il rendering del browser non garantisce che una pagina si caricherà correttamente, e le modalità resilienti non garantiscono che il nuovo tentativo produrrà un risultato diverso.

Limiti di utilizzo specifici di Scrape

Questi limiti si applicano specificamente all'API Scrape. Potrebbero applicarsi anche altri salvaguardie di account e piattaforma.

Capacità Account gratuiti Account paganti
Modalità disponibili Solo standard Tutte e quattro le modalità
Tasso di richiesta 5 richieste al minuto 60 richieste al minuto
Richieste concorrenti standard o resilienti 1 richiesta standard 5 richieste
Richieste concorrenti renderizzate Non disponibile 2 richieste
Indennità giornaliera 100 richieste In base ai crediti disponibili e ai limiti di tariffa
Indennità mensile 500 richieste In base ai crediti disponibili e ai limiti di tariffa
Contenuto massimo restituito 256 KiB per richiesta 512 KiB per richiesta
Batch asincroni Non disponibile Disponibile

Quando una risposta supera il limite di contenuto applicabile, l'API restituisce la porzione consentita e contrassegna la risposta come troncata.

Elabora fino a 100 URL in modo asincrono

Gli account paganti possono inviare un lavoro asincrono contenente fino a 100 URL.

Fino a 5 nuovi lavori batch al minuto

Fino a 3 lavori attivi per account

Fino a 300 elementi URL in coda per account

Fino a 100 URL in un lavoro

Risultati completati disponibili per 24 ore

Metadati del lavoro conservati per 7 giorni

Ogni URL viene fatturato indipendentemente utilizzando la modalità selezionata.

Scarica o copia i risultati completati entro 24 ore. Dopo quel periodo, il contenuto della risposta viene rimosso anche se i metadati limitati del lavoro rimangono disponibili per 7 giorni.

Ambito chiaro, senza opzioni di aggiornamento nascoste

Nessuna risoluzione CAPTCHA

Il rendering del browser può eseguire JavaScript della pagina, ma l'API Scrape non risolve CAPTCHA o non aggira requisiti di accesso, paywall, controlli di accesso o altre restrizioni. Un CAPTCHA o una pagina di sfida restituita dalla destinazione è un risultato del sito di destinazione e non è rimborsabile.

Nessuna selezione proxy premium

Scegli la modalità di recupero e il livello di sforzo. Non c'è parametro proxy premium, fornitore, pool o selezione paese.

Utilizzo accettabile

Usa l'API Scrape solo per il contenuto a cui sei legalmente autorizzato ad accedere e elaborare. Sei responsabile della conformità alle leggi applicabili, ai termini del sito di destinazione, agli obblighi di privacy e alle autorizzazioni richieste.

Non utilizzare l'API per aggirare l'autenticazione, paywall, CAPTCHA o controlli di accesso, o per attacchi con credenziali, abuso di account, molestie, sorveglianza illegale o raccolta illegale di dati personali. DomScan può rifiutare richieste o sospendere l'accesso quando l'uso minaccia persone, servizi o la piattaforma.

Segnali di fiducia prima dell’integrazione

Documentazione trasparente, richieste autenticate e dettagli di affidabilità visibili rendono più semplice valutare DomScan prima del rilascio.

Stato del servizio Artefatti API

OpenAPI, Swagger, Postman, CLI, SDK e link MCP sono a un clic.

Chiavi API Accesso protetto

Gli endpoint autenticati usano chiavi API con costi in crediti chiari prima della chiamata.

Quota gratuita Iscriviti Gratuitamente

Inizia con 10.000 crediti mensili e fai upgrade solo quando l’uso cresce.

Attivo Richiesta di esempio

Parti dagli esempi curl e HTTP, poi mappa i parametri nel codice della tua applicazione.

Caratteristiche Principali

Scegli lo sforzo di recupero per ogni URL

I crediti si basano sulla modalità che richiedi, non sullo stato HTTP o sul contenuto restituito dal sito web di destinazione.

La fatturazione riflette il lavoro richiesto

Un'operazione API riuscita significa che DomScan ha eseguito la modalità di recupero selezionata e restituito il risultato del sito di destinazione.

Elabora fino a 100 URL in modo asincrono

Gli account paganti possono inviare un lavoro asincrono contenente fino a 100 URL.

Limiti di utilizzo specifici di Scrape

Questi limiti si applicano specificamente all'API Scrape. Potrebbero applicarsi anche altri salvaguardie di account e piattaforma.

Nessuna risoluzione CAPTCHA

Il rendering del browser può eseguire JavaScript della pagina, ma l'API Scrape non risolve CAPTCHA o non aggira requisiti di accesso, paywall, controlli di accesso o altre restrizioni. Un CAPTCHA o una pagina di sfida restituita dalla destinazione è un risultato del sito di destinazione e non è rimborsabile.

Utilizzo accettabile

Usa l'API Scrape solo per il contenuto a cui sei legalmente autorizzato ad accedere e elaborare. Sei responsabile della conformità alle leggi applicabili, ai termini del sito di destinazione, agli obblighi di privacy e alle autorizzazioni richieste.

Richiesta di esempio

Richiesta standard bash
curl -X POST "https://domscan.net/v1/scrape" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/","mode":"standard","output":"markdown"}'
Richiesta renderizzata dal browser bash
curl -X POST "https://domscan.net/v1/scrape" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/app","mode":"rendered","output":"html"}'
Richiesta di batch asincrono bash
curl -X POST "https://domscan.net/v1/scrape/jobs" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Idempotency-Key: docs-batch-1" \
  -H "Content-Type: application/json" \
  -d '{"mode":"standard","output":"text","urls":["https://example.com/page-1","https://example.com/page-2"]}'

Risposta di esempio

Risposta standard riuscita json
{
  "data": {
    "url": "https://example.com/",
    "final_url": "https://example.com/",
    "status": 200,
    "outcome": "success",
    "content_type": "text/html",
    "content": "<!doctype html>...",
    "bytes": 1256,
    "truncated": false,
    "redirect_count": 0,
    "attempt_count": 1,
    "duration_ms": 428,
    "fetched_at": "2026-08-20T10:30:00.000Z",
    "headers": { "cache-control": "max-age=604800" },
    "rendered": false
  },
  "billing": {
    "credits_charged": 1,
    "credits_refunded": 0,
    "policy": "effort_based"
  }
}

Domande Frequenti

Quanti crediti costa un URL?

Un URL costa 1, 2, 10 o 20 crediti a seconda della modalità selezionata. Gli elementi batch utilizzano lo stesso prezzo per URL.

Mi viene addebitato se la destinazione restituisce un errore o una pagina di blocco?

Sì. Le risposte di destinazione come reindirizzamenti, errori HTTP, blocchi, pagine di sfida, pagine vuote o contenuto inaspettato sono addebitabili perché DomScan ha comunque eseguito il lavoro di recupero richiesto.

Quando viene rimborsata una richiesta?

Un rimborso è disponibile solo quando DomScan verifica che la sua stessa piattaforma non ha eseguito la modalità di recupero selezionata. Il comportamento del sito di destinazione non è un guasto della piattaforma.

La modalità resiliente continua a tentare finché la pagina non funziona?

No. La modalità resiliente include un nuovo tentativo quando il primo risultato soddisfa le condizioni di nuovo tentativo documentate.

Il rendering del browser risolve i CAPTCHA?

No. Esegue JavaScript della pagina ma non risolve CAPTCHA o non aggira restrizioni di accesso.

Posso selezionare un proxy premium o un paese?

No. L'API non espone livelli di proxy, fornitori, pool o targeting di paese. Scegli solo la modalità di recupero.

Gli account gratuiti possono inviare lavori batch?

No. I batch asincroni sono disponibili solo agli account paganti. Gli account gratuiti possono utilizzare la modalità standard entro i limiti gratuiti pubblicati.

Quanto tempo vengono archiviati i risultati del batch?

Il contenuto della risposta completato è disponibile per 24 ore. I metadati limitati del lavoro rimangono disponibili per 7 giorni.

Strumenti e Risorse Correlati

Codici di stato HTTP

Documentiamo i codici di stato HTTP che il tuo client dovrebbe gestire per distinguere risposte riuscite, problemi di autenticazione, crediti, limiti di richiesta, dati mancanti ed errori upstream.

OK 200

Richiesta riuscita

Accettato 202

Mancato risultato cache-only per i sottodomini accettato per aggiornamento in background. Non vengono addebitati crediti; riprova dopo il ritardo Retry-After.

Richiesta non valida 400

Parametri non validi

Non autorizzato 401

Chiave API o sessione mancante o non valida.

Pagamento richiesto 402

Crediti insufficienti per eseguire questa richiesta.

Vietato 403

Autenticato, ma non autorizzato a usare questa operazione o modalità.

HTTP 409 409

Documentiamo i codici di stato HTTP che il tuo client dovrebbe gestire per distinguere risposte riuscite, problemi di autenticazione, crediti, limiti di richiesta, dati mancanti ed errori upstream.

Troppe richieste 429

Limite di richieste superato

Servizio non disponibile 503

Il servizio a monte non è disponibile o sta limitando temporaneamente le richieste.

Ottieni una chiave API