Controlla lo stato del servizio in tempo reale e le risposte di errore documentate prima dell’integrazione.
Utilizzato da persone di aziende straordinarie
Segnali di fiducia prima dell’integrazione
Documentazione trasparente, richieste autenticate e dettagli di affidabilità visibili rendono più semplice valutare DomScan prima del rilascio.
OpenAPI, Swagger, Postman, CLI, SDK e link MCP sono a un clic.
Gli endpoint autenticati usano chiavi API con costi in crediti chiari prima della chiamata.
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.
Integra controlli dominio, intelligence DNS, segnali di rischio o arricchimento in onboarding, ricerca e strumenti interni.
Sostituisci lookup manuali ripetuti con job pianificati, alert e passaggi di indagine riproducibili.
Usa campi prevedibili, codici di stato documentati e costi in crediti invece di fare scraping di pagine provider.
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.
Invia la tua chiave API con l’header documentato e mantieni richieste coerenti tra servizi.
Parti dagli esempi curl e HTTP, poi mappa i parametri nel codice della tua applicazione.
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.
Genera client o ispeziona ogni forma di richiesta e risposta.
Collezione PostmanImporta richieste pronte per test manuali e handoff al team.
SDK e CLIUsa pacchetti mantenuti e workflow da riga di comando invece di scrivere boilerplate.
Integrazione MCPEsponi intelligence sui domini ad agenti AI e assistenti interni.
Mappa di parametri e risposta
Controlla input, campi di output e codici di stato prima di collegare l’endpoint al tuo client.
Parametro
Risposta di esempio
Codici di stato HTTP
Endpoint
/v1/scrape
/v1/scrape/jobs
/v1/scrape/jobs/:job_id
/v1/scrape/jobs/:job_id/results
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.
OpenAPI, Swagger, Postman, CLI, SDK e link MCP sono a un clic.
Gli endpoint autenticati usano chiavi API con costi in crediti chiari prima della chiamata.
Inizia con 10.000 crediti mensili e fai upgrade solo quando l’uso cresce.
Parti dagli esempi curl e HTTP, poi mappa i parametri nel codice della tua applicazione.
Caratteristiche Principali
I crediti si basano sulla modalità che richiedi, non sullo stato HTTP o sul contenuto restituito dal sito web di destinazione.
Un'operazione API riuscita significa che DomScan ha eseguito la modalità di recupero selezionata e restituito il risultato del sito di destinazione.
Gli account paganti possono inviare un lavoro asincrono contenente fino a 100 URL.
Questi limiti si applicano specificamente all'API Scrape. Potrebbero applicarsi anche altri salvaguardie di account e piattaforma.
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.
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
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"}'
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"}'
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
{
"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
Un URL costa 1, 2, 10 o 20 crediti a seconda della modalità selezionata. Gli elementi batch utilizzano lo stesso prezzo per URL.
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.
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.
No. La modalità resiliente include un nuovo tentativo quando il primo risultato soddisfa le condizioni di nuovo tentativo documentate.
No. Esegue JavaScript della pagina ma non risolve CAPTCHA o non aggira restrizioni di accesso.
No. L'API non espone livelli di proxy, fornitori, pool o targeting di paese. Scegli solo la modalità di recupero.
No. I batch asincroni sono disponibili solo agli account paganti. Gli account gratuiti possono utilizzare la modalità standard entro i limiti gratuiti pubblicati.
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.
Richiesta riuscita
Mancato risultato cache-only per i sottodomini accettato per aggiornamento in background. Non vengono addebitati crediti; riprova dopo il ritardo Retry-After.
Parametri non validi
Chiave API o sessione mancante o non valida.
Crediti insufficienti per eseguire questa richiesta.
Autenticato, ma non autorizzato a usare questa operazione o modalità.
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.
Limite di richieste superato
Il servizio a monte non è disponibile o sta limitando temporaneamente le richieste.
Ottieni una chiave API