Dati web

API di convalida dei dati strutturati

Estragga ogni elemento JSON-LD, Microdata e RDFa da una pagina e lo convalidi in base alle regole delle proprietà schema.org per i tipi più comuni di risultati avanzati. Ottenga errori, avvisi e l'esatta proprietà da correggere.

Consulta la documentazione Prova lo strumento gratuito Esplora tutte le API

Endpoint Attivo

GET /v1/structured-data

Richiesta di esempio

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

Risposta di esempio 200 OK

{
  "status": "ok",
  "summary": { "json_ld": 2, "microdata": 1, "rdfa": 0, "total_items": 9, "errors": 1, "warnings": 5 },
  "types": ["AggregateRating", "BreadcrumbList", "ListItem", "Offer", "Product", "Review"],
  "items": [
    {
      "format": "json-ld",
      "types": ["Product"],
      "status": "warnings",
      "errors": [],
      "warnings": [{ "
...

Richiesta di esempio GET /v1/structured-data

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

statussummarysummary.json_ldsummary.microdatasummary.rdfasummary.total_itemssummary.errorssummary.warningstypesitems

Copertura stati

Codici di stato HTTP

200400401402429

Endpoint

GET /v1/structured-data

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

Tre formati

Blocchi JSON-LD con @graph appiattito, elementi Microdata ed elementi RDFa, con oggetti annidati come offerte, valutazioni e autori mantenuti come elementi figli.

Regole per i risultati avanzati

Proprietà obbligatorie e consigliate per 26 tipi, tra cui Product, Offer, Article, Organization, LocalBusiness, BreadcrumbList, FAQPage, Event, Recipe, VideoObject e JobPosting.

Controlli sui valori

Date, prezzi, valutazioni e URL vengono controllati nel formato, e un JSON non valido o un contesto diverso da schema.org viene segnalato per l'intero blocco.

Markup renderizzato

Imposti render=true per leggere i dati strutturati che i tag manager o i framework JavaScript inseriscono dopo il caricamento della pagina.

Richiesta di esempio

GET /v1/structured-data?url=example.com/shoes/trail-runner bash

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

Risposta di esempio

200 OK json

{
  "status": "ok",
  "summary": { "json_ld": 2, "microdata": 1, "rdfa": 0, "total_items": 9, "errors": 1, "warnings": 5 },
  "types": ["AggregateRating", "BreadcrumbList", "ListItem", "Offer", "Product", "Review"],
  "items": [
    {
      "format": "json-ld",
      "types": ["Product"],
      "status": "warnings",
      "errors": [],
      "warnings": [{ "code": "missing_recommended", "property": "description" }]
    }
  ]
}

Domande frequenti

È lo stesso di un test di idoneità ai risultati avanzati?

No. Controlla il markup rispetto alle regole pubblicate sulle proprietà schema.org. I motori di ricerca decidono l'idoneità con le proprie policy e i propri segnali di qualità, quindi un elemento valido non garantisce un risultato avanzato.

Che cosa succede con i tipi che non hanno regole?

Vengono comunque estratti con tutte le loro proprietà e restituiti con status unchecked, così può vederli senza falsi errori.

Posso vedere i valori delle proprietà?

Sì. Ogni elemento elenca le sue proprietà e un'anteprima dei primi 200 caratteri di ogni valore di testo.

Quanti crediti costa?

Due crediti per l'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

Convalida i dati strutturati

Inizia gratis Consulta la documentazione Prova lo strumento gratuito