Skip to main content
GET
/
api
/
registry
/
agents
/
search
Search agent inventory profiles
curl --request GET \
  --url https://agenticadvertising.org/api/registry/agents/search
{
  "results": [
    {
      "agent_url": "<string>",
      "channels": [
        "<string>"
      ],
      "property_types": [
        "<string>"
      ],
      "markets": [
        "<string>"
      ],
      "categories": [
        "<string>"
      ],
      "tags": [
        "<string>"
      ],
      "delivery_types": [
        "<string>"
      ],
      "format_ids": [
        "<unknown>"
      ],
      "property_count": 123,
      "publisher_count": 123,
      "has_tmp": true,
      "category_taxonomy": "<string>",
      "relevance_score": 123,
      "matched_filters": [
        "<string>"
      ],
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "cursor": "<string>",
  "has_more": true
}

Query Parameters

​
channels
string

Comma-separated channel filter

Example:

"ctv,olv"

​
property_types
string

Comma-separated property type filter

Example:

"ctv_app,website"

​
markets
string

Comma-separated market/country code filter

Example:

"US,GB"

​
categories
string

Comma-separated IAB content category filter

Example:

"IAB-7,IAB-7-1"

​
tags
string

Comma-separated tag filter

Example:

"premium"

​
delivery_types
string

Comma-separated delivery type filter

Example:

"guaranteed,programmatic"

​
has_tmp
enum<string>

Require TMP support

Available options:
true,
false
​
min_properties
integer | null

Minimum number of properties in inventory

Required range: x >= 0
​
cursor
string

Pagination cursor from a previous response

​
limit
integer

Max results per page (default 50, max 200)

Required range: 1 <= x <= 200

Response

Search results ranked by relevance

​
results
object[]
required
​
cursor
string | null
required
​
has_more
boolean
required