Dati web

API per i link di una pagina e la verifica dei link interrotti

Elenchi ogni link di una pagina con il suo testo di ancoraggio, i valori rel e il tipo interno o esterno, poi verifichi fino a 25 destinazioni univoche per trovare i link interrotti. Solo un 404, un 410 esatto o un host che non esiste è considerato interrotto.

Consulta la documentazione Prova lo strumento gratuito Esplora tutte le API

Endpoint Attivo

GET /v1/links

Richiesta di esempio

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/links?url=example.com/shoes/trail-runner&check=true"

Risposta di esempio 200 OK

{
  "status": "ok",
  "summary": { "total": 7, "internal": 5, "external": 2, "nofollow": 1, "empty_anchor": 1 },
  "check": {
    "checked": 7,
    "ok": 4,
    "redirect": 1,
    "broken": 1,
    "unknown": 1,
    "results": [
      { "url": "https://example.com/missing-page", "state": "broken", "http_status": 404 },
      { "url": "https://partner.example.
...

Richiesta di esempio GET /v1/links

Caratteristiche Principali 4

Domande frequenti 4

Codici di stato HTTP 200 / 400 / 401 / 402 / 429

Categoria Dati web

Endpoint 1

Caratteristiche Principali 4

Domande frequenti 4

Usato da persone di queste aziende

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.

Autentica una volta

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

Interroga con esempi

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

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.

Schema OpenAPI

Genera client o ispeziona ogni forma di richiesta e risposta.

Collezione Postman

Importa richieste pronte per test manuali e handoff al team.

SDK e CLI

Usa pacchetti mantenuti e workflow da riga di comando invece di scrivere boilerplate.

Integrazione MCP

Esponi 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.

Parametri richiesta

Parametro

urlrenderchecktypelimit

Campi risposta

Risposta di esempio

statussummarysummary.totalsummary.internalsummary.externalsummary.nofollowsummary.empty_anchorcheckcheck.checkedcheck.okcheck.redirectcheck.broken

Copertura stati

Codici di stato HTTP

200400401402429

Endpoint

GET /v1/links

Crediti: 2-6Autenticazione: Autenticazione richiesta

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 gratis

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

Inventario completo dei link

URL, testo di ancoraggio o alt dell'immagine, valori rel e flag nofollow, ugc o sponsored per ogni link, con i totali di link interni, esterni, ancoraggi vuoti e domini esterni.

Controllo dei link interrotti

Imposti check=true per testare fino a 25 destinazioni univoche e vedere quali sono ok, reindirizzate, interrotte o sconosciute, con l'URL finale e il codice di stato.

Nessun falso allarme

I controlli bloccati, limitati, falliti e andati in timeout restano sconosciuti. Un link è interrotto solo con prove esatte come un 404 o un 410.

Link JavaScript

Imposti render=true per elencare i link che JavaScript aggiunge dopo il caricamento della pagina, come i menu e le griglie di prodotti nelle applicazioni a pagina singola.

Richiesta di esempio

GET /v1/links?url=example.com/shoes/trail-runner&check=true bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/links?url=example.com/shoes/trail-runner&check=true"

Risposta di esempio

200 OK json

{
  "status": "ok",
  "summary": { "total": 7, "internal": 5, "external": 2, "nofollow": 1, "empty_anchor": 1 },
  "check": {
    "checked": 7,
    "ok": 4,
    "redirect": 1,
    "broken": 1,
    "unknown": 1,
    "results": [
      { "url": "https://example.com/missing-page", "state": "broken", "http_status": 404 },
      { "url": "https://partner.example.org/fit-guide", "state": "unknown", "reason": "blocked" }
    ]
  }
}

Domande frequenti

Perché vengono controllati solo 25 link?

Ogni controllo è una vera richiesta al sito di destinazione, quindi i controlli sono limitati per mantenere rapide le risposte e rispettosi i siti a cui rimanda. Le destinazioni univoche oltre il limite vengono conteggiate come non controllate.

Posso controllare solo i link interni o esterni?

Sì. Imposti type=internal o type=external per elencare e controllare solo quei link. Il riepilogo conta sempre ogni link della pagina.

Posso combinare render=true e check=true?

Non in una sola richiesta. Esegua una richiesta con rendering per elencare i link, poi una richiesta con controllo sulla pagina grezza, oppure verifichi URL specifici con l'API di reindirizzamento.

Quanti crediti costa?

Due crediti per elencare i link, sei crediti con render=true e sei crediti con check=true. I risultati che terminano con status unknown vengono rimborsati.

Strumenti e risorse correlati

Codici di stato HTTP

Questi sono i codici di stato HTTP da gestire, per distinguere risposte riuscite, problemi di autenticazione, crediti, limiti di frequenza, dati mancanti ed errori a monte.

OK 200

Richiesta riuscita

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.

Troppe richieste 429

Limite di richieste superato

Controlla i link della pagina

Inizia gratis Consulta la documentazione Prova lo strumento gratuito