Skip to main content
GET
/
api
/
registry
/
publisher
Publisher lookup
curl --request GET \
  --url https://agenticadvertising.org/api/registry/publisher
{
  "domain": "voxmedia.com",
  "member": {
    "slug": "<string>",
    "display_name": "<string>"
  },
  "adagents_valid": true,
  "hosting": {
    "mode": "self",
    "expected_url": "<string>",
    "hosted_url": "<string>",
    "origin_verified_at": "<string>",
    "origin_last_checked_at": "<string>"
  },
  "properties": [
    {
      "id": "<string>",
      "type": "<string>",
      "name": "<string>",
      "identifiers": [
        {
          "type": "domain",
          "value": "examplepub.com"
        }
      ],
      "tags": [
        "<string>"
      ],
      "source": "adagents_json",
      "delegation_type": "direct"
    }
  ],
  "authorized_agents": [
    {
      "url": "<string>",
      "source": "adagents_json",
      "authorized_for": "<string>",
      "properties_authorized": 1,
      "properties_total": 1,
      "publisher_wide": true
    }
  ],
  "files": {
    "adagents_json": {
      "status": "valid",
      "expected_url": "<string>"
    },
    "brand_json": {
      "status": "present",
      "name": "<string>"
    }
  },
  "rollup_truncated": {
    "cap": 123,
    "total_agents": 1
  },
  "auto_crawl_triggered": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.adcontextprotocol.org/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

​
domain
string
required
Example:

"voxmedia.com"

Response

Publisher lookup result

​
domain
string
required
Example:

"voxmedia.com"

​
member
object
required
​
adagents_valid
boolean | null
required
​
hosting
object
required
​
properties
object[]
required
​
authorized_agents
object[]
required
​
files
object

Plain-English summary of what AAO has found at the publisher's origin. The publisher page leads with this — you have a valid adagents.json is the primary signal, not mode === self. Optional in the schema for backwards compatibility; the handler always populates it.

​
rollup_truncated
object

Set when the publisher has more authorized agents than the per-agent rollup cap. Above the cap, agents beyond cap are returned without properties_authorized / properties_total / publisher_wide; call /api/registry/publisher/authorization?domain=X&agent=Y for the per-agent count. Lets a caller decide whether to fan out individual calls or stop reading.

​
auto_crawl_triggered
boolean

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.