Search agent inventory profiles
curl --request GET \
--url https://agenticadvertising.org/api/registry/agents/search \
--header 'Authorization: Bearer <token>'{
"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
}Agent Discovery
Search agent inventory profiles
Search agents by inventory profile — channels, markets, content categories, property types, and more. Filters use AND across dimensions and OR within a dimension. Results are ranked by relevance score.
GET
/
api
/
registry
/
agents
/
search
Search agent inventory profiles
curl --request GET \
--url https://agenticadvertising.org/api/registry/agents/search \
--header 'Authorization: Bearer <token>'{
"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
}Authorizations
bearerAuthoauth2
Bearer token in the Authorization header. Two token types are accepted:
- Organization API key (
sk_...) issued via the dashboard. Org-scoped, long-lived, for server-to-server use. - User JWT obtained via the OAuth 2.1 authorization code flow with PKCE. User-scoped, short-lived. Discover the authorization server at
/.well-known/oauth-authorization-serverand the protected-resource metadata at/.well-known/oauth-protected-resource/api.
Query Parameters
Comma-separated channel filter
Example:
"ctv,olv"
Comma-separated property type filter
Example:
"ctv_app,website"
Comma-separated market/country code filter
Example:
"US,GB"
Comma-separated IAB content category filter
Example:
"IAB-7,IAB-7-1"
Comma-separated tag filter
Example:
"premium"
Comma-separated delivery type filter
Example:
"guaranteed,programmatic"
Require TMP support
Available options:
true, false Minimum number of properties in inventory
Required range:
x >= 0Pagination cursor from a previous response
Max results per page (default 50, max 200)
Required range:
1 <= x <= 200Was this page helpful?
⌘I