`list_watched_competitors`

List the businesses your organization watches on Brand Watch (the competitor ad library), plus strategy competitors not yet watched. Same data as the dashboard’s Brand Watch tab: per-competitor ad counts, platforms, last successful pull time, and whether an initial pull is still running.

This is a cached read — it never fetches from ad platforms or the ad-intel vendor.

Parameters#

None.

Returns#

json

{
  "competitors": [
    {
      "id": 42,
      "name": "Acme Corp",
      "domain": "acme.com",
      "logo_url": "https://…/logo.png",
      "role": "inspiration",
      "ad_count": 37,
      "platforms": ["google", "meta"],
      "last_pulled_at": "2026-07-10T04:12:00+00:00",
      "is_pulling": false
    }
  ],
  "count": 1,
  "untracked_strategy_competitors": [
    { "name": "Rival Inc", "domain": "rival.io", "logo_url": "", "ads_available": 12 }
  ],
  "source": "adlyse.brand_watch@v1"
}

Field	Description
`competitors[].role`	`inspiration` or `competitor` (strategic)
`competitors[].last_pulled_at`	Finish time of the last successful ad pull for the domain (null = never)
`competitors[].is_pulling`	True while the first pull is still running (no ads captured yet)
`untracked_strategy_competitors`	Competitors researched in the Brand Profile but not watched; `ads_available` counts spine ads already cached, so watching them can fill instantly

Errors#

`error_type`	When
`auth_error`	Missing / invalid API key