{"openapi":"3.1.0","info":{"title":"ads.txt API","version":"1.0.0","description":"Fetch and evaluate any publisher's ads.txt / app-ads.txt — the IAB authorized-digital-sellers standard. Pass a domain and the check endpoint fetches its ads.txt server-side, then returns every seller record parsed into its fields — advertising system, the publisher's seller/account id, the DIRECT or RESELLER relationship and the optional certification-authority id (TAG-ID) — alongside counts (direct, reseller, distinct ad systems) and the declared variables OWNERDOMAIN, MANAGERDOMAIN, CONTACT and SUBDOMAINS. The verify endpoint answers the one question programmatic-advertising integrations actually ask: is this advertising system, with this publisher id, authorized to sell this domain's inventory? — returning an authorized boolean and the matching records. A missing file is reported as found:false (not an error), and soft-404 HTML pages are detected and rejected so you never parse a \"page not found\" as records. The request is made server-side and private or internal targets are refused (SSRF-guarded). Built for ad-tech supply-chain verification, SSP/DSP onboarding checks, anti-fraud and inventory audits. An ads.txt seller-authorization checker — distinct from the security-contact file reader (securitytxt), the robots.txt crawlability evaluator (robots) and the sitemap parser (sitemap). No upstream key, no cache.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/adstxt-api","description":"oanor gateway"}],"tags":[{"name":"ads.txt"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/check":{"get":{"operationId":"get_v1_check","tags":["ads.txt"],"summary":"Fetch & parse a domain's ads.txt","description":"","parameters":[{"name":"domain","in":"query","required":true,"description":"The publisher domain","schema":{"type":"string"},"example":"theguardian.com"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"url":"https://theguardian.com/ads.txt","found":true,"counts":{"direct":43,"comments":29,"reseller":53,"advertising_systems":34},"domain":"theguardian.com","records":[{"publisher_id":"pub-2012933198307164","relationship":"DIRECT","advertising_system":"google.com"},{"publisher_id":"3722","relationship":"DIRECT","advertising_system":"aps.amazon.com"},{"publisher_id":"2888","relationship":"DIRECT","advertising_system":"appnexus.com"},{"publisher_id":"7012","relationship":"DIRECT","advertising_system":"appnexus.com"},{"publisher_id":"184842","relationship":"DIRECT","advertising_system":"indexexchange.com","certification_authority_id":"50b1c356f2c5c8fc"},{"publisher_id":"185406","relationship":"DIRECT","advertising_system":"indexexchange.com","certification_authority_id":"50b1c356f2c5c8fc"},{"publisher_id":"205118","relationship":"DIRECT","advertising_system":"indexexchange.com","certification_authority_id":"50b1c356f2c5c8fc"},{"publisher_id":"205545","relationship":"DIRECT","advertising_system":"indexexchange.com","certification_authority_id":"50b1c356f2c5c8fc"},{"publisher_id":"157189","relationship":"DIRECT","advertising_system":"pubmatic.com","certification_authority_id":"5d62403b186f2ace"},{"publisher_id":"157207","relationship":"DIRECT","advertising_system":"pubmatic.com","certification_authority_id":"5d62403b186f2ace"},{"publisher_id":"157203","relationship":"DIRECT","advertising_system":"pubmatic.com","certification_authority_id":"5d62403b186f2ace"},{"publisher_id":"157206","relationship":"DIRECT","advertising_system":"pubmatic.com","certification_authority_id":"5d62403b186f2ace"},{"publisher_id":"161064","relationship":"DIRECT","advertising_system":"pubmatic.com","certification_authority_id":"5d62403b186f2ace"},{"publisher_id":"539997011","relationship":"DIRECT","advertising_system":"openx.com","certification_authority_id":"6a698e2ec38604c6"},{"publisher_id":"539997005","relationship":"DIRECT","advertising_system":"openx.com","certification_authority_id":"6a698e2ec38604c6"},{"publisher_id":"539997010","relationship":"DIRECT","advertising_system":"openx.com","certification_authority_id":"6a698e2ec38604c6"},{"publisher_id":"559090935","relationship":"DIRECT","advertising_system":"openx.com","certification_authority_id":"6a698e2ec38604c6"},{"publisher_id":"541135108","relationship":"RESELLER","advertising_system":"openx.com","certification_authority_id":"6a698e2ec38604c6"},{"publisher_id":"560437416","relationship":"DIRECT","advertising_system":"openx.com","certification_authority_id":"6a698e2ec38604c6"},{"publisher_id":"564251974","relationship":"DIRECT","advertising_system":"openx.com","certification_authority_id":"6a698e2ec38604c6"},{"publisher_id":"OZONEGMG0001","relationship":"DIRECT","advertising_system":"the-ozone-project.com"},{"publisher_id":"160557","relationship":"RESELLER","advertising_system":"pubmatic.com","certification_authority_id":"5d62403b186f2ace"},{"publisher_id":"2657","relationship":"RESELLER","advertising_system":"adform.com","certification_authority_id":"9f5210a2f0999e32"},{"publisher_id":"206233","relationship":"RESELLER","advertising_system":"indexexchange.com","certification_authority_id":"50b1c356f2c5c8fc"},{"publisher_id":"9979","relationship":"RESELLER","advertising_system":"appnexus.com"},{"publisher_id":"540731760","relationship":"RESELLER","advertising_system":"openx.com","certification_authority_id":"6a698e2ec38604c6"},{"publisher_id":"2127","relationship":"RESELLER","advertising_system":"appnexus.com","certification_authority_id":"f5ab79cb980f11d1"},{"publisher_id":"26644","relationship":"DIRECT","advertising_system":"rubiconproject.com","certification_authority_id":"0bfd66d529a55807"},{"publisher_id":"8095","relationship":"DIRECT","advertising_system":"teads.tv","certification_authority_id":"15a9c44f6d26cbe1"},{"publisher_id":"2167","relationship":"DIRECT","advertising_system":"teads.tv","certification_authority_id":"15a9c44f6d26cbe1"},{"publisher_id":"21333","relationship":"DIRECT","advertising_system":"teads.tv","certification_authority_id":"15a9c44f6d26cbe1"},{"publisher_id":"B-060725","relationship":"DIRECT","advertising_system":"criteo.com","certification_authority_id":"9fac4a4a87c2a44f"},{"publisher_id":"T751LV","relationship":"DIRECT","advertising_system":"themediagrid.com","certification_authority_id":"35d5010d7789b49d"},{"publisher_id":"RYIDPE","relationship":"RESELLER","advertising_system":"themediagrid.com","certification_authority_id":"35d5010d7789b49d"},{"publisher_id":"a027ca58f0d6223bc79b02f5d5f73374","relationship":"DIRECT","advertising_system":"adyoulike.com","certification_authority_id":"4ad745ead2958bf7"},{"publisher_id":"sp_AYL2022","relationship":"RESELLER","advertising_system":"spotim.market","certification_authority_id":"077e5f709d15bdbb"},{"publisher_id":"7664","relationship":"RESELLER","advertising_system":"appnexus.com"},{"publisher_id":"2885","relationship":"DIRECT","advertising_system":"triplelift.com","certification_authority_id":"6c33edb13117fd86"},{"publisher_id":"13862","relationship":"DIRECT","advertising_system":"triplelift.com","certification_authority_id":"6c33edb13117fd86"},{"publisher_id":"3855","relationship":"DIRECT","advertising_system":"smartadserver.com"},{"publisher_id":"3855","relationship":"DIRECT","advertising_system":"sharethrough.com","certification_authority_id":"d53b998a7bd4ecd2"},{"publisher_id":"8764","relationship":"DIRECT","advertising_system":"kargo.com"},{"publisher_id":"16053","relationship":"DIRECT","advertising_system":"gumgum.com","certification_authority_id":"ffdef49475d318a9"},{"publisher_id":"23434","relationship":"RESELLER","advertising_system":"rubiconproject.com","certification_authority_id":"0bfd66d529a55807"},{"publisher_id":"157897","relationship":"RESELLER","advertising_system":"pubmatic.com","certification_authority_id":"5d62403b186f2ace"},{"publisher_id":"2758","relationship":"RESELLER","advertising_system":"appnexus.com","certification_authority_id":"f5ab79cb980f11d1"},{"publisher_id":"pub-2012933198307164","relationship":"DIRECT","advertising_system":"theglobeandmail.com"},{"publisher_id":"1285","relationship":"RESELLER","advertising_system":"appnexus.com"},{"publisher_id":"181495","relationship":"RESELLER","advertising_system":"indexexchange.com"},{"publisher_id":"185292","relationship":"RESELLER","advertising_system":"indexexchange.com"},{"publisher_id":"pub-3746578658400510","relationship":"RESELLER","advertising_system":"google.com","certification_authority_id":"f08c47fec0942fa0"},{"publisher_id":"24730","relationship":"RESELLER","advertising_system":"rubiconproject.com","certification_authority_id":"0bfd66d529a55807"},{"publisher_id":"8b1be605","relationship":"RESELLER","advertising_system":"sharethrough.com","certification_authority_id":"d53b998a7bd4ecd2"},{"publisher_id":"8CUM4F58G","relationship":"RESELLER","advertising_system":"media.net","certification_authority_id":"818f58666cabc936"},{"publisher_id":"167626","relationship":"RESELLER","advertising_system":"pubmatic.com","certification_authority_id":"5d62403b186f2ace"},{"publisher_id":"167624","relationship":"RESELLER","advertising_system":"pubmatic.com","certification_authority_id":"5d62403b186f2ace"},{"publisher_id":"3dba53d1-d083-4b23-a413-a37d34431980","relationship":"DIRECT","advertising_system":"ogury.com"},{"publisher_id":"11470","relationship":"RESELLER","advertising_system":"appnexus.com"},{"publisher_id":"163238","relationship":"RESELLER","advertising_system":"pubmatic.com","certification_authority_id":"5d62403b186f2ace"},{"publisher_id":"4537","relationship":"RESELLER","advertising_system":"smartadserver.com","certification_authority_id":"060d053dcf45cbf3"},{"publisher_id":"25198","relationship":"RESELLER","advertising_system":"rubiconproject.com","certification_authority_id":"0bfd66d529a55807"},{"publisher_id":"429135572456470","relationship":"DIRECT","advertising_system":"connatix.com","certification_authority_id":"2af98acdee0e81ed"},{"publisher_id":"17444","relationship":"RESELLER","advertising_system":"appnexus.com","certification_authority_id":"f5ab79cb980f11d1"},{"publisher_id":"pub-1929615694373103","relationship":"RESELLER","advertising_system":"google.com","certification_authority_id":"f08c47fec0942fa0"},{"publisher_id":"12991","relationship":"RESELLER","advertising_system":"gumgum.com","certification_authority_id":"ffdef49475d318a9"},{"publisher_id":"190549","relationship":"RESELLER","advertising_system":"indexexchange.com","certification_authority_id":"50b1c356f2c5c8fc"},{"publisher_id":"64d831e7ed4840ac8ea2283745f07d75","relationship":"RESELLER","advertising_system":"inmobi.com","certification_authority_id":"83e75a7ae333ca9d"},{"publisher_id":"11186","relationship":"RESELLER","advertising_system":"loopme.com","certification_authority_id":"6c8d5f95897a5a3b"},{"publisher_id":"8CUP5F2LD","relationship":"RESELLER","advertising_system":"media.net"},{"publisher_id":"539496816","relationship":"RESELLER","advertising_system":"openx.com","certification_authority_id":"6a698e2ec38604c6"},{"publisher_id":"23208720669","relationship":"RESELLER","advertising_system":"ottadvisors.com"},{"publisher_id":"156592","relationship":"RESELLER","advertising_system":"pubmatic.com","certification_authority_id":"5d62403b186f2ace"},{"publisher_id":"19564","relationship":"RESELLER","advertising_system":"rubiconproject.com","certification_authority_id":"0bfd66d529a55807"},{"publisher_id":"1100055555","relationship":"RESELLER","advertising_system":"smaato.com","certification_authority_id":"07bcf65f187117b4"},{"publisher_id":"3630","relationship":"RESELLER","advertising_system":"smartadserver.com"},{"publisher_id":"12200","relationship":"RESELLER","advertising_system":"triplelift.com","certification_authority_id":"6c33edb13117fd86"},{"publisher_id":"687806135","relationship":"RESELLER","advertising_system":"video.unrulymedia.com"},{"publisher_id":"1","relationship":"DIRECT","advertising_system":"theguardian.com"},{"publisher_id":"8CU35O67G","relationship":"DIRECT","advertising_system":"media.net"},{"publisher_id":"5d9f0b616449d90600f8f1f1","relationship":"DIRECT","advertising_system":"seedtag.com"},{"publisher_id":"157743","relationship":"RESELLER","advertising_system":"pubmatic.com","certification_authority_id":"5d62403b186f2ace"},{"publisher_id":"3050","relationship":"RESELLER","advertising_system":"smartadserver.com"},{"publisher_id":"17280","relationship":"RESELLER","advertising_system":"rubiconproject.com","certification_authority_id":"0bfd66d529a55807"},{"publisher_id":"810441027","relationship":"DIRECT","advertising_system":"video.unrulymedia.com"},{"publisher_id":"795867070","relationship":"RESELLER","advertising_system":"video.unrulymedia.com"},{"publisher_id":"1251","relationship":"DIRECT","advertising_system":"blis.com","certification_authority_id":"61453ae19a4b73f4"},{"publisher_id":"16928","relationship":"RESELLER","advertising_system":"rubiconproject.com","certification_authority_id":"0bfd66d529a55807"},{"publisher_id":"29IN8P","relationship":"RESELLER","advertising_system":"themediagrid.com","certification_authority_id":"35d5010d7789b49d"},{"publisher_id":"100024","relationship":"DIRECT","advertising_system":"yahoo.com","certification_authority_id":"e1a5b5b6e3255540"},{"publisher_id":"3441510","relationship":"DIRECT","advertising_system":"infolinks.com"},{"publisher_id":"156872","relationship":"RESELLER","advertising_system":"pubmatic.com","certification_authority_id":"5d62403b186f2ace"},{"publisher_id":"3251","relationship":"RESELLER","advertising_system":"xandr.com"},{"publisher_id":"191306","relationship":"RESELLER","advertising_system":"indexexchange.com"},{"publisher_id":"543174347","relationship":"RESELLER","advertising_system":"openx.com","certification_authority_id":"6a698e2ec38604c6"},{"publisher_id":"100026","relationship":"RESELLER","advertising_system":"yahoo.com","certification_authority_id":"e1a5b5b6e3255540"},{"publisher_id":"8CUY6IX4H","relationship":"RESELLER","advertising_system":"media.net"}],"variables":{"subdomains":[],"owner_domain":"theguardian.com","manager_domain":"theglobeandmail.com"},"record_count":96},"meta":{"timestamp":"2026-06-01T23:40:38.459Z","request_id":"84699f73-930b-4271-a390-e32979506c3f"},"status":"ok","message":"ads.txt parsed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/verify":{"get":{"operationId":"get_v1_verify","tags":["ads.txt"],"summary":"Is a seller authorized?","description":"","parameters":[{"name":"domain","in":"query","required":true,"description":"The publisher domain","schema":{"type":"string"},"example":"theguardian.com"},{"name":"system","in":"query","required":true,"description":"Advertising system domain","schema":{"type":"string"},"example":"google.com"},{"name":"publisher_id","in":"query","required":true,"description":"Seller/account id","schema":{"type":"string"},"example":"pub-0000000000000000"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"domain":"theguardian.com","system":"google.com","matches":[],"authorized":false,"match_count":0,"publisher_id":"pub-0000000000000000"},"meta":{"timestamp":"2026-06-01T23:40:38.624Z","request_id":"ae94076c-83a3-471c-9d56-d0b6973ba7d1"},"status":"ok","message":"Seller verified","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Fetch and parse a publisher's ads.txt — the IAB Authorized Digital Sellers file that lists who is allowed to sell a site's ad inventory. /v1/check?domain=theguardian.com fetches domain/ads.txt and returns every seller record (the advertising-system domain, the publisher account id, the DIRECT or RESELLER relationship and the optional certification-authority id, e.g. Google's TAG id), the counts of direct vs reseller lines, and the variables (OWNERDOMAIN, MANAGERDOMAIN, CONTACT, SUBDOMAINS). /v1/verify?domain=...&system=google.com&publisher_id=... checks whether a specific advertising system (and account) is authorised — the exact lookup an SSP or buyer makes to prevent domain spoofing and unauthorised reselling. A soft-404 HTML page is treated as no ads.txt. The request is made server-side; private/internal targets are refused (SSRF-guarded). Ideal for ad-tech compliance, supply-path verification, fraud prevention and publisher audits. An ads.txt parser/validator — distinct from the robots.txt evaluator (robots), the security.txt parser (securitytxt) and the sitemap parser (sitemap). No key, no cache.","spec":"IAB Tech Lab ads.txt (Authorized Digital Sellers)","endpoints":["/v1/check","/v1/verify","/v1/meta"],"variables":["CONTACT","SUBDOMAINS","OWNERDOMAIN","MANAGERDOMAIN","INVENTORYPARTNERDOMAIN"],"relationships":["DIRECT","RESELLER"]},"meta":{"timestamp":"2026-06-01T23:40:38.718Z","request_id":"496cfd68-ab3d-4692-b5a7-73d7c3b552ba"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2090,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":615,"monthly_call_quota":40000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2025,"monthly_call_quota":212000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5260,"monthly_call_quota":808000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/adstxt-api"}