Sign in

v1

latestOpenAPI 3.1.02026-07-2210284274.4 KB
Authorization Lookups

Publisher lookup

Given a domain, returns the inventory this entity publishes and which agents it authorizes.

This endpoint is unauthenticated and returns the same response shape for every caller. Compare to /api/registry/operator, where AAO membership tier and profile ownership unlock additional agent visibility (members_only, private). AAO membership does not change the /publisher response today.

Property source precedence: publisher-attested adagents.json properties win first. When no publisher-attested adagents properties exist for the domain, brand.json properties supplement and override lower-trust rows, followed by approved community catalogs, then crawler-discovered rows. Each property carries a source field (adagents_json / brand_json / community / discovered).

Per-agent rollup: each entry in authorized_agents may carry properties_authorized + properties_total + publisher_wide. The rollup is suppressed (fields absent) when (a) properties are entirely brand.json-hydrated — no adagents.json claim has been made — or (b) the publisher has more than 50 authorized agents (above-cap entries are returned without rollup; rollup_truncated is set with { cap, total_agents }). Use /api/registry/publisher/authorization?domain=X&agent=Y for the per-agent count when the index rollup is absent.

get/api/registry/publisher

Query parameters

domainstring required
Example:voxmedia.com

Response

Publisher lookup result

domainstring required
adagents_validboolean nullable required
discovery_method'direct' | 'authoritative_location' | 'ads_txt_managerdomain' | 'adagents_authoritative' | 'community_catalog' | 'null' nullable

How the publisher's adagents.json was discovered on the most recent successful crawl or registry write. direct: publisher's own /.well-known/ served the document. authoritative_location: publisher's stub redirected to a canonical URL. ads_txt_managerdomain: manifest was discovered via ads.txt MANAGERDOMAIN delegation. adagents_authoritative: manager file named this publisher through publisher_properties fan-out. community_catalog: moderator-approved community catalog. Null until first crawl after migration 470.

manager_domainstring nullable

The manager domain whose adagents.json was used to authorize this publisher's agents. Non-null only when discovery_method is ads_txt_managerdomain. Matches the MANAGERDOMAIN value from the publisher's ads.txt.

auto_crawl_triggeredboolean

Set to true when this request triggered a background crawl of the publisher's origin (we hadn't crawled before). The client should refetch in ~3-5s to pick up fresh data. Debounced per-domain so a tight refresh loop won't keep firing crawls.

Example response

{
  "domain": "voxmedia.com",
  "properties": [
    {
      "identifiers": [
        {
          "type": "domain",
          "value": "examplepub.com"
        }
      ]
    }
  ]
}