Skip to main content
GET
/
v1
/
agents
/
{encodedUrl}
/
publishers
AAO directory inverse-lookup
curl --request GET \
  --url https://agenticadvertising.org/v1/agents/{encodedUrl}/publishers
{
  "agent_url": "<string>",
  "directory_indexed_at": "2023-11-07T05:31:56Z",
  "publishers": [
    {
      "publisher_domain": "<string>",
      "manager_domain": "<string>",
      "properties_authorized": 1,
      "properties_total": 1,
      "signing_keys_pinned": true,
      "last_verified_at": "2023-11-07T05:31:56Z",
      "property_ids": [
        "<string>"
      ]
    }
  ],
  "next_cursor": "<string>"
}

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.

Path Parameters

​
encodedUrl
string
required

Percent-encoded agent_url

Query Parameters

​
since
string<date-time>

ISO 8601 — return only publishers with last_verified_at ≥ since

​
cursor
string

Opaque pagination cursor returned by a prior response

​
status
enum<string>[]

Lifecycle status filter — repeat the key once per value (?status=authorized&status=revoked). Default: authorized. The comma-separated single-value form is rejected with 400.

Available options:
authorized,
revoked
​
include
enum<string>[]

Opt into expanded per-row fields — repeat the key once per value. v1: properties adds property_ids[] to each PublisherEntry so consumers can run full set-diff against a federated fetch (count-equality is not set-equality). Unknown values return 400. The comma-separated form is rejected with 400.

Available options:
properties
​
limit
integer

Page size, default 200, max 1000

Required range: 1 <= x <= 1000

Response

Publishers authorizing the agent

​
agent_url
string
required
​
directory_indexed_at
string<date-time> | null
required

Most recent per-publisher refresh in this page. Null on empty pages (no anchor).

​
publishers
object[]
required
​
next_cursor
string | null
required