Webdaten

API zur Validierung von ads.txt und sellers.json

Prüfen Sie, welche Unternehmen das Werbeinventar einer Website verkaufen dürfen. Werten Sie ads.txt oder app-ads.txt aus, markieren Sie ungültige Zeilen und Duplikate und bestätigen Sie jeden Verkäufer anhand der eigenen sellers.json des Werbesystems.

Kategorie Webdaten
Endpunkte 1
Hauptfunktionen 4
Häufig gestellte Fragen 4

Wird von Mitarbeitenden dieser Unternehmen genutzt

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse

Vertrauenssignale vor der Integration

Transparente Dokumentation, authentifizierte Anfragen und sichtbare Zuverlässigkeitsdetails erleichtern die Bewertung von DomScan vor dem Launch.

Live Dienststatus

Prüfen Sie vor der Integration den aktuellen Dienstzustand und die dokumentierten Fehlerantworten.

OpenAPI API-Artefakte

OpenAPI, Swagger, Postman, CLI, SDK und MCP-Links sind nur einen Klick entfernt.

API-Schlüssel Geschützter Zugriff

Authentifizierte Endpunkte nutzen API-Schlüssel mit klaren Credit-Kosten vor dem Aufruf.

10,000 Kostenloses Kontingent

Starte mit 10.000 monatlichen Credits und upgrade erst, wenn die Nutzung wächst.

Wobei diese API beim Bauen hilft

Nutze diese Seite als Produktionsbriefing: Endpoints, Beispiele, Antwortstruktur und Workflow-Bausteine, um DomScan in dein Produkt einzubinden.

Produkt-Workflows

Bette Domainchecks, DNS-Intelligence, Risikosignale oder Anreicherung in Onboarding, Suche und interne Tools ein.

Analysten-Automatisierung

Ersetze wiederholte manuelle Lookups durch geplante Jobs, Alerts und reproduzierbare Untersuchungsschritte.

Saubere JSON-Daten

Nutze vorhersehbare Felder, dokumentierte Statuscodes und Credit-Kosten statt Provider-Seiten zu scrapen.

KI- und Ops-Tools

Versorge Agenten, Dashboards, SOAR-Playbooks und CRMs über OpenAPI, SDK, Postman oder MCP.

Integrationsablauf

Ein einfacher Weg von der ersten Anfrage bis zur wiederholbaren Nutzung in Produktion.

1
Einmal authentifizieren

Sende deinen API-Schlüssel mit dem dokumentierten Header und halte Anfragen über Services hinweg konsistent.

2
Mit Beispielen abfragen

Starte mit den curl- und HTTP-Beispielen und übertrage die Parameter dann in deinen Anwendungscode.

3
Betreiben und überwachen

Nutze Statuscodes, Credit-Kosten und Antwortfelder, um Retries, Logs und Alerts zu bauen.

Developer-Kit

Wechsle von dieser Seite zu maschinenlesbaren Docs, Request-Sammlungen, SDKs oder Agenten-Tools.

Parameter- und Antwortkarte

Prüfe Eingaben, Ausgabefelder und Statuscodes, bevor du den Endpoint in deinen Client einbindest.

Request-Parameter

Parameter

urlfileverify_sellers
Antwortfelder

Beispielantwort

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

HTTP-Statuscodes

200400401402429

Endpunkte

GET /v1/ads-txt
Credits: 2-5Authentifizierung: Authentifizierung erforderlich

Vertrauenssignale vor der Integration

Transparente Dokumentation, authentifizierte Anfragen und sichtbare Zuverlässigkeitsdetails erleichtern die Bewertung von DomScan vor dem Launch.

Dienststatus API-Artefakte

OpenAPI, Swagger, Postman, CLI, SDK und MCP-Links sind nur einen Klick entfernt.

API-Schlüssel Geschützter Zugriff

Authentifizierte Endpunkte nutzen API-Schlüssel mit klaren Credit-Kosten vor dem Aufruf.

Kostenloses Kontingent Kostenlos anmelden

Starte mit 10.000 monatlichen Credits und upgrade erst, wenn die Nutzung wächst.

Aktiv Beispielanfrage

Starte mit den curl- und HTTP-Beispielen und übertrage die Parameter dann in deinen Anwendungscode.

Hauptfunktionen

ads.txt und app-ads.txt

Prüfen Sie die Web-Datei oder die Version für Mobilgeräte und Connected TV, mit jedem Eintrag, jeder Beziehung und der ID der Zertifizierungsstelle.

Verkäuferbestätigung

Mit verify_sellers=true wird jede Verkäufer-ID in der sellers.json des Werbesystems nachgeschlagen und als bestätigt, vertraulich, type mismatch oder nicht gefunden markiert.

Syntaxprüfungen

Ungültige Zeilen, unbekannte Beziehungen, fehlende Konto-IDs, fehlerhafte Domains und doppelte Einträge werden mit ihren Zeilennummern gezählt.

Variablen

Deklarationen von OWNERDOMAIN, MANAGERDOMAIN, CONTACT, SUBDOMAIN und INVENTORYPARTNERDOMAIN werden unverändert zurückgegeben.

Beispielanfrage

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"

Beispielantwort

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

Häufig gestellte Fragen

Was bedeutet type_mismatch?

Die sellers.json führt die Verkäufer-ID auf, aber mit einem Typ, der nicht zur Beziehung passt, zum Beispiel ein PUBLISHER-Eintrag für eine RESELLER-Zeile.

Warum sind manche Verkäufer unbekannt?

Die sellers.json des Werbesystems konnte nicht gelesen werden, war zu groß oder fehlerhaft. Unbekannt bedeutet nie, dass der Verkäufer fehlt.

Wie viele Werbesysteme werden geprüft?

Bis zu 10 pro Anfrage, beginnend mit den Systemen, die die meisten Einträge und DIRECT-Beziehungen haben.

Wie viele Credits kostet es?

Zwei Credits, mit verify_sellers=true fünf. Ergebnisse, die mit status unknown enden, werden erstattet.

Verwandte Tools und Ressourcen

HTTP-Statuscodes

Das sind die HTTP-Statuscodes, die Sie behandeln sollten, damit Sie erfolgreiche Antworten, Authentifizierungsprobleme, Credits, Ratenlimits, fehlende Daten und Upstream-Fehler unterscheiden können.

OK 200

Anfrage erfolgreich

Ungültige Anfrage 400

Ungültige Parameter

Nicht autorisiert 401

API-Schlüssel oder Sitzung fehlt oder ist ungültig.

Zahlung erforderlich 402

Nicht genügend Credits für diese Anfrage.

Zu viele Anfragen 429

Ratenlimit überschritten