Webdata

API voor ads.txt- en sellers.json-validatie

Controleer welke bedrijven advertentie-inventaris van een site mogen verkopen. Parse ads.txt of app-ads.txt, markeer ongeldige regels en duplicaten en bevestig elke verkoper aan de hand van de eigen sellers.json van het advertentiesysteem.

Categorie Webdata
Endpoints 1
Belangrijkste functies 4
Veelgestelde vragen 4

Gebruikt door mensen bij deze bedrijven

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse

Vertrouwenssignalen voordat je integreert

Transparante documentatie, geauthenticeerde requests en zichtbare betrouwbaarheidsdetails maken DomScan makkelijker te beoordelen voor livegang.

Actief Servicestatus

Controleer vóór de integratie de live servicestatus en de gedocumenteerde foutreacties.

OpenAPI API-artifacts

OpenAPI, Swagger, Postman, CLI, SDK en MCP-links zijn één klik verwijderd.

API-sleutels Beschermde toegang

Geauthenticeerde endpoints gebruiken API-sleutels met duidelijke creditkosten voordat je ze aanroept.

10,000 Gratis tegoed

Begin met 10.000 maandelijkse credits en upgrade pas wanneer het gebruik groeit.

Wat deze API je helpt bouwen

Gebruik deze pagina als productiebriefing: endpoints, voorbeelden, responsstructuur en workflow-onderdelen om DomScan in je product te koppelen.

Productworkflows

Integreer domeinchecks, DNS-intelligence, risicosignalen of verrijking in onboarding, zoeken en interne tools.

Analistautomatisering

Vervang herhaalde handmatige lookups door geplande taken, alerts en reproduceerbare onderzoeksstappen.

Schone JSON-data

Gebruik voorspelbare velden, gedocumenteerde statuscodes en kredietkosten in plaats van providerpagina’s te scrapen.

AI- en ops-tools

Voed agents, dashboards, SOAR-playbooks en CRMs via OpenAPI, SDK, Postman of MCP.

Integratieworkflow

Een eenvoudig pad van de eerste request naar herhaalbaar productiegebruik.

1
Eenmalig authenticeren

Stuur je API-sleutel met de gedocumenteerde header en houd requests consistent tussen services.

2
Query met voorbeelden

Start met de curl- en HTTP-voorbeelden en map daarna de parameters naar je applicatiecode.

3
Opereren en monitoren

Gebruik statuscodes, kredietkosten en responsvelden om retries, logs en alerts te bouwen.

Developerkit

Ga vanaf deze pagina naar machineleesbare docs, requestcollecties, SDKs of agenttools.

Parameter- en responskaart

Bekijk inputs, outputvelden en statuscodes voordat je het endpoint in je client aansluit.

Requestparameters

Parameter

urlfileverify_sellers
Responsvelden

Voorbeeldantwoord

statussummarysummary.recordssummary.directsummary.resellersummary.ad_systemsvariablesvariables.ownerdomainissuessellerssellers.systems_checkedsellers.confirmed
Statusdekking

HTTP-statuscodes

200400401402429

Endpoints

GET /v1/ads-txt
Tegoeden: 2-5Authenticatie: Authenticatie vereist

Vertrouwenssignalen voordat je integreert

Transparante documentatie, geauthenticeerde requests en zichtbare betrouwbaarheidsdetails maken DomScan makkelijker te beoordelen voor livegang.

Servicestatus API-artifacts

OpenAPI, Swagger, Postman, CLI, SDK en MCP-links zijn één klik verwijderd.

API-sleutels Beschermde toegang

Geauthenticeerde endpoints gebruiken API-sleutels met duidelijke creditkosten voordat je ze aanroept.

Gratis tegoed Gratis registreren

Begin met 10.000 maandelijkse credits en upgrade pas wanneer het gebruik groeit.

Actief Voorbeeldverzoek

Start met de curl- en HTTP-voorbeelden en map daarna de parameters naar je applicatiecode.

Belangrijkste functies

ads.txt en app-ads.txt

Valideer het webbestand of de versie voor mobiel en connected tv, met elk record, elke relatie en elk certificeringsinstantie-ID.

Verkopersbevestiging

Met verify_sellers=true wordt elk verkoper-ID opgezocht in de sellers.json van het advertentiesysteem en gemarkeerd als bevestigd, vertrouwelijk, type_mismatch of niet gevonden.

Syntaxcontroles

Ongeldige regels, onbekende relaties, ontbrekende account-ID's, ongeldige domeinen en dubbele records worden geteld met hun regelnummers.

Variabelen

Declaraties van OWNERDOMAIN, MANAGERDOMAIN, CONTACT, SUBDOMAIN en INVENTORYPARTNERDOMAIN worden teruggegeven zoals ze zijn aangetroffen.

Voorbeeldverzoek

GET /v1/ads-txt?url=example.com&verify_sellers=true bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/ads-txt?url=example.com&verify_sellers=true"

Voorbeeldantwoord

200 OK json
{
  "status": "found",
  "summary": { "records": 401, "direct": 94, "reseller": 307, "ad_systems": 98 },
  "variables": { "ownerdomain": ["example.com"] },
  "issues": [{ "code": "duplicate_record", "count": 47, "lines": [68, 76, 77] }],
  "sellers": {
    "systems_checked": 10,
    "confirmed": 58,
    "type_mismatch": 7,
    "seller_not_found": 16,
    "unknown": 9
  }
}

Veelgestelde vragen

Wat betekent type_mismatch?

De sellers.json vermeldt het verkoper-ID, maar met een type dat niet bij de relatie past, bijvoorbeeld een PUBLISHER-vermelding voor een RESELLER-regel.

Waarom zijn sommige verkopers onbekend?

De sellers.json van het advertentiesysteem kon niet worden gelezen, was te groot of was onjuist opgebouwd. Onbekend betekent nooit dat de verkoper ontbreekt.

Hoeveel advertentiesystemen worden geverifieerd?

Maximaal 10 per verzoek, te beginnen met de systemen met de meeste records en DIRECT-relaties.

Hoeveel credits kost het?

Twee credits, of vijf met verify_sellers=true. Resultaten die eindigen in status unknown worden terugbetaald.

Gerelateerde hulpprogramma's en bronnen

HTTP-statuscodes

Dit zijn de HTTP-statuscodes die je moet afhandelen, zodat je succesvolle responses, authenticatieproblemen, credits, ratelimieten, ontbrekende gegevens en upstreamfouten kunt onderscheiden.

OK 200

Aanvraag geslaagd

Ongeldig verzoek 400

Ongeldige parameters

Niet geautoriseerd 401

Ontbrekende dan wel ongeldige API-sleutel of sessie.

Betaling vereist 402

Niet genoeg credits om deze aanvraag uit te voeren.

Te veel verzoeken 429

Snelheidslimiet overschreden