Check property list

Check a list of publisher domains against the AAO registry. Normalizes domains (strips www/m prefixes), removes duplicates, flags known ad tech infrastructure, and identifies domains not yet in the registry.

Returns four buckets:

• remove: duplicates or known blocked domains (ad servers, CDNs, trackers, intermediaries)
• modify: domains that were normalized (e.g. www.example.com → example.com)
• assess: unknown domains not in registry, not blocked
• ok: domains found in registry with no changes needed

Results are stored for 7 days and retrievable via the report_id.

POST /api/properties/check

Check property list

cURL

curl --request POST \
  --url https://agenticadvertising.org/api/properties/check \
  --header 'Content-Type: application/json' \
  --data '
{
  "domains": [
    "www.nytimes.com",
    "googlesyndication.com",
    "wsj.com"
  ]
}
'

200

{
  "summary": {
    "total": 123,
    "remove": 123,
    "modify": 123,
    "assess": 123,
    "ok": 123
  },
  "remove": [
    {
      "input": "<string>",
      "canonical": "<string>",
      "domain_type": "<string>",
      "blocked_reason": "<string>"
    }
  ],
  "modify": [
    {
      "input": "<string>",
      "canonical": "<string>",
      "reason": "<string>"
    }
  ],
  "assess": [
    {
      "domain": "<string>"
    }
  ],
  "ok": [
    {
      "domain": "<string>",
      "source": "<string>"
    }
  ],
  "report_id": "<string>"
}

Body

application/json

domains · string[] · required

Maximum array length: 10000

Example:

[
  "www.nytimes.com",
  "googlesyndication.com",
  "wsj.com"
]

Response

200

application/json

Property list check results

summary · object · required

Show child attributes

remove · object[] · required

Show child attributes

modify · object[] · required

Show child attributes

assess · object[] · required

Show child attributes

ok · object[] · required

Show child attributes

report_id · string · required

UUID for retrieving this report later