Dati web

API di analisi SEO on-page

Analizzi una pagina per richiesta e ottenga ogni segnale SEO on-page in un'unica risposta JSON: meta tag, direttive canonical e robots, struttura delle intestazioni, numero di parole, link, immagini, Open Graph e dati strutturati, più 38 controlli ponderati e un punteggio da 0 a 100. Aggiunga render=true per analizzare la pagina dopo l'esecuzione di JavaScript.

Consulta la documentazione Prova lo strumento gratuito Esplora tutte le API

Endpoint Attivo

GET /v1/onpage

Richiesta di esempio

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

Risposta di esempio 200 OK

{
  "status": "ok",
  "score": 87,
  "meta": {
    "title": "Trail Running Shoes for Rocky Terrain | Example Outdoor",
    "title_length": 55,
    "canonical_self_referencing": true,
    "indexable": true
  },
  "headings": { "h1": ["Trail Running Shoes for Rocky Terrain"] },
  "content": { "word_count": 122, "text_to_html_ratio": 0.221 },
  "checks": [
...

Richiesta di esempio GET /v1/onpage

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

urlrender

Campi risposta

Risposta di esempio

statusscoremetameta.titlemeta.title_lengthmeta.canonical_self_referencingmeta.indexableheadingsheadings.h1contentcontent.word_countcontent.text_to_html_ratio

Copertura stati

Codici di stato HTTP

200400401402429

Endpoint

GET /v1/onpage

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

Grezzo o renderizzato

Analizzi l'HTML inviato dal suo server, oppure imposti render=true per analizzare la pagina dopo l'esecuzione di JavaScript in un browser isolato, come i crawler moderni vedono le applicazioni a pagina singola.

38 controlli ponderati

Ogni controllo restituisce superato, avviso, errore o non applicabile con un livello di gravità, dai titoli mancanti e dai canonical in conflitto ai contenuti misti, alle immagini senza testo alternativo e ai livelli di intestazione saltati.

Ogni segnale in una sola chiamata

Lunghezza di titolo e descrizione, meta robots e X-Robots-Tag, lingua, viewport, favicon, Open Graph, Twitter cards, numero di link e immagini e tipi di dati strutturati.

Sconosciuti dichiarati con onestà

I recuperi bloccati, limitati o falliti restituiscono status unknown con un motivo e vengono rimborsati, così una pagina che non è stato possibile leggere non sembra mai una pagina in ordine.

Richiesta di esempio

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

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

Risposta di esempio

200 OK json

{
  "status": "ok",
  "score": 87,
  "meta": {
    "title": "Trail Running Shoes for Rocky Terrain | Example Outdoor",
    "title_length": 55,
    "canonical_self_referencing": true,
    "indexable": true
  },
  "headings": { "h1": ["Trail Running Shoes for Rocky Terrain"] },
  "content": { "word_count": 122, "text_to_html_ratio": 0.221 },
  "checks": [
    { "id": "mixed_content", "status": "fail", "severity": "high", "value": 1 },
    { "id": "images_alt", "status": "warn", "severity": "medium", "value": 1 }
  ],
  "issues": ["mixed_content", "heading_hierarchy", "word_count", "images_alt"]
}

Domande frequenti

Come viene calcolato il punteggio?

I controlli di gravità alta valgono 10 punti, medi 5 e bassi 2. Un controllo superato ottiene il peso pieno, un avviso ne ottiene la metà e un errore non ottiene nulla. I controlli non applicabili, come il testo alternativo delle immagini in una pagina senza immagini, vengono esclusi.

Quando devo usare render=true?

Lo usi per le pagine create con framework JavaScript, in cui titoli, contenuti o link compaiono solo dopo l'esecuzione degli script. Confronti entrambe le versioni con l'API JavaScript SEO per vedere esattamente che cosa cambia.

Esegue la scansione dell'intero sito?

No. Ogni richiesta analizza un solo URL, così lei controlla quali pagine vengono verificate e quanto spende. La combini con l'API di analisi delle sitemap per scegliere gli URL da analizzare.

Quanti crediti costa?

Due crediti per un'analisi dell'HTML grezzo e sei crediti con render=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

Analizza una pagina

Inizia gratis Consulta la documentazione Prova lo strumento gratuito