Webbdata

API för validering av ads.txt och sellers.json

Kontrollera vilka företag som är behöriga att sälja en webbplats annonsinventarie. Tolka ads.txt eller app-ads.txt, flagga ogiltiga rader och dubbletter och bekräfta varje säljare mot annonssystemets egen sellers.json.

Visa dokumentation Prova gratisverktyget Utforska alla API:er

Slutpunkter Aktiv

GET /v1/ads-txt

Exempelbegäran

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

Exempelsvar 200 OK

{
  "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,
    "un
...

Exempelbegäran GET /v1/ads-txt

Nyckelfunktioner 4

Vanliga frågor 4

HTTP-statuskoder 200 / 400 / 401 / 402 / 429

Category Webbdata

Slutpunkter 1

Nyckelfunktioner 4

Vanliga frågor 4

Används av människor på dessa företag

Förtroendesignaler före integration

Transparent dokumentation, autentiserade anrop och synliga tillförlitlighetsdetaljer gör DomScan lättare att utvärdera före lansering.

I drift Tjänstestatus

Kontrollera tjänstens aktuella status och dokumenterade felsvar innan du integrerar.

OpenAPI API-material

OpenAPI, Swagger, Postman, CLI, SDK och MCP-länkar finns ett klick bort.

API-nycklar Skyddad åtkomst

Autentiserade endpoints använder API-nycklar med tydliga kreditkostnader före anrop.

10,000 Gratis kvot

Börja med 10 000 krediter per månad och uppgradera först när användningen växer.

Vad detta API hjälper dig att leverera

Använd sidan som en produktionsbrief: endpoints, exempel, responsform och workflow-delar som krävs för att koppla DomScan till din produkt.

Produktworkflows

Bädda in domänkontroller, DNS-intelligence, risksignaler eller berikning i onboarding, sök och interna verktyg.

Analystautomatisering

Ersätt upprepade manuella lookups med schemalagda jobb, alerts och reproducerbara utredningssteg.

Ren JSON-data

Använd förutsägbara fält, dokumenterade statuskoder och kreditkostnader istället för att skrapa leverantörssidor.

AI- och ops-verktyg

Mata agenter, dashboards, SOAR-playbooks och CRM:er via OpenAPI, SDK, Postman eller MCP.

Integrationsworkflow

En enkel väg från första request till repeterbar produktion.

Autentisera en gång

Skicka din API-nyckel med dokumenterad header och håll requests konsekventa mellan tjänster.

Fråga med exempel

Börja med curl- och HTTP-exempel och mappa sedan parametrarna till din applikationskod.

Drifta och övervaka

Använd statuskoder, kreditkostnader och responsfält för retries, loggar och alerts.

Utvecklarkit

Gå från sidan till maskinläsbara docs, request-samlingar, SDK:er eller agentverktyg.

OpenAPI-schema

Generera klienter eller inspektera varje request- och responsform.

Postman-samling

Importera färdiga requests för manuell testning och teamöverlämning.

SDK:er och CLI

Använd underhållna paket och command-line workflows istället för boilerplate.

MCP-integration

Exponera domänintelligence för AI-agenter och interna assistentworkflows.

Parameter- och responskarta

Granska inputs, outputfält och statuskoder innan endpointen kopplas in i din klient.

Requestparametrar

Parameter

urlfileverify_sellers

Responsfält

Exempelsvar

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

Statustäckning

HTTP-statuskoder

200400401402429

Slutpunkter

GET /v1/ads-txt

Krediter: 2-5Autentisering: Autentisering krävs

Förtroendesignaler före integration

Transparent dokumentation, autentiserade anrop och synliga tillförlitlighetsdetaljer gör DomScan lättare att utvärdera före lansering.

Tjänstestatus API-material

OpenAPI, Swagger, Postman, CLI, SDK och MCP-länkar finns ett klick bort.

API-nycklar Skyddad åtkomst

Autentiserade endpoints använder API-nycklar med tydliga kreditkostnader före anrop.

Gratis kvot Registrera dig gratis

Börja med 10 000 krediter per månad och uppgradera först när användningen växer.

Aktiv Exempelbegäran

Börja med curl- och HTTP-exempel och mappa sedan parametrarna till din applikationskod.

Nyckelfunktioner

ads.txt och app-ads.txt

Validera webbfilen eller versionen för mobil och uppkopplad tv, med varje post, relation och ID för certifieringsmyndighet.

Säljarbekräftelse

Med verify_sellers=true slås varje säljar-ID upp i annonssystemets sellers.json och markeras som bekräftad, konfidentiell, typfel (type_mismatch) eller hittades inte.

Syntaxkontroller

Ogiltiga rader, okända relationer, saknade konto-ID:n, felaktiga domäner och dubbla poster räknas med sina radnummer.

Variabler

Deklarationer av OWNERDOMAIN, MANAGERDOMAIN, CONTACT, SUBDOMAIN och INVENTORYPARTNERDOMAIN returneras som de hittades.

Exempelbegäran

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"

Exempelsvar

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
  }
}

Vanliga frågor

Vad betyder type_mismatch?

Sellers.json listar säljar-ID:t, men med en typ som inte matchar relationen, till exempel en PUBLISHER-post för en RESELLER-rad.

Varför är vissa säljare okända?

Annonssystemets sellers.json kunde inte läsas, var för stor eller hade felaktigt format. Okänd betyder aldrig att säljaren saknas.

Hur många annonssystem verifieras?

Upp till 10 per förfrågan, med början i de system som har flest poster och DIRECT-relationer.

Hur många krediter kostar det?

Två krediter, eller fem med verify_sellers=true. Resultat som slutar med status unknown återbetalas.

Relaterade verktyg och resurser

HTTP-statuskoder

Det här är de HTTP-statuskoder som du bör hantera, så att du kan skilja mellan lyckade svar, autentiseringsproblem, krediter, hastighetsgränser, saknade data och fel hos externa tjänster.

OK 200

Begäran lyckades

Felaktig begäran 400

Ogiltiga parametrar

Obehörig 401

API-nyckel eller session saknas eller är ogiltig.

Betalning krävs 402

Det finns inte tillräckligt med krediter för att köra denna begäran.

För många begäranden 429

Hastighetsgränsen överskriden

Validera ads.txt

Borja gratis Visa dokumentation Prova gratisverktyget