Skip to content

Add brand and property registry lookup methods #129

@bokelley

Description

@bokelley

Summary

Add methods to the Python client for looking up brands and properties from the AdCP registry, including bulk operations for operational workflows.

New Methods

Brand Lookups

  • lookup_brand(domain: str) — resolve a single domain to its canonical brand identity via GET /api/brands/resolve
  • lookup_brands(domains: list[str]) — bulk resolve via POST /api/brands/resolve/bulk, returns dict[str, ResolvedBrand | None]

Property Lookups

  • lookup_property(domain: str) — resolve a publisher domain to its property info via GET /api/properties/resolve
  • lookup_properties(domains: list[str]) — bulk resolve via POST /api/properties/resolve/bulk, returns dict[str, PropertyInfo | None]

API Endpoints

The server-side bulk endpoints are implemented in adcontextprotocol/adcp#1035:

  • POST /api/brands/resolve/bulk — accepts { "domains": [...] } (max 100), returns { "results": { domain: brand | null } }
  • POST /api/properties/resolve/bulk — same pattern for properties

Use Case

Operational workflows need to resolve many domains efficiently — e.g., "I have 500 domains from a campaign report, which brands/properties do they map to?" The bulk methods avoid N+1 HTTP calls.

🤖 Generated with Claude Code

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions