---
title: "Search agent inventory profiles"
method: GET
path: "/api/registry/agents/search"
tags: ["Agent Discovery"]
---

# Search agent inventory profiles

`GET /api/registry/agents/search`

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.

## Query parameters

- `channels` string — Comma-separated channel filter
- `property_types` string — Comma-separated property type filter
- `markets` string — Comma-separated market/country code filter
- `categories` string — Comma-separated IAB content category filter
- `tags` string — Comma-separated tag filter
- `delivery_types` string — Comma-separated delivery type filter
- `has_tmp` 'true' | 'false' — Require TMP support
- `min_properties` integer, nullable — Minimum number of properties in inventory
- `cursor` string — Pagination cursor from a previous response
- `limit` integer — Max results per page (default 50, max 200)

## Response `200`

Search results ranked by relevance

- object
  - `results` object[], required
    - `agent_url` string, uri, required
    - `channels` string[], required
    - `property_types` string[], required
    - `markets` string[], required
    - `categories` string[], required
    - `tags` string[], required
    - `delivery_types` string[], required
    - `format_ids` unknown[], required — Creative format identifiers supported by this agent
      - unknown
    - `property_count` integer, required
    - `publisher_count` integer, required
    - `has_tmp` boolean, required
    - `category_taxonomy` string, nullable, required
    - `relevance_score` number, required
    - `matched_filters` string[], required
    - `updated_at` string, date-time, required
  - `cursor` string, nullable, required
  - `has_more` boolean, required

## Other responses

- `400` — Invalid cursor or parameter
- `401` — Authentication required

---

[API](https://skmtc.net/adcontextprotocol/apis/agenticadvertising-org-registry-api.md) · [All operations](https://skmtc.net/adcontextprotocol/apis/agenticadvertising-org-registry-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adcontextprotocol/agenticadvertising-org-registry-api/versions/9ea7fedf54c0/schema)