`meta_ads_list_competitor_ads`

List Competitor Ads

Description

List a competitor's ads from the scraped Meta Ad Library corpus — real creative content (copy, CTA, landing URL, media metadata), not just snapshot links. Filter by active_only (still running), display_format (image, video, carousel, text), since (seen on/after a date), and search (full-text over ad copy). Requires no Meta connection — the corpus is maintained by Hopkin's daily scrape of tracked advertisers. Get advertiser IDs from meta_ads_list_tracked_competitors or meta_ads_track_competitor.

Read-onlyIdempotent

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "meta_ads_list_competitor_ads",
    "arguments": {
      "advertiser_id": "adv-uuid-from-tracked-list",
      "reason": "Review a competitor’s current creative strategy"
    }
  }
}

hopkin meta competitor-ads list

Flag	Type	Required	Description
`--advertiser-id`	`string`	Required	The advertiser ID from meta_ads_list_tracked_competitors or meta_ads_track_competitor
`--active-only`	`boolean`	Optional	Only ads still running (no stopped_running_at)
`--display-format`	`string`	Optional	Filter by creative format as Meta labels it (case-insensitive). Observed values: image, video, carousel, multi_images, dco, dpa. dco and dpa are Meta's dynamic formats (dynamic creative and catalog/advantage+ ads) and are the most common in the corpus.
`--since`	`string`	Optional	Only ads seen on or after this ISO date/timestamp (e.g. 2026-07-01)
`--search`	`string`	Optional	Case-insensitive search over ad copy (primary text, headline, description)
`--limit`	`integer`	Optional	Number of ads per page (default: 20, max: 100)
`--cursor`	`string`	Optional	Pagination cursor from previous response

{
  "mcpServers": {
    "meta-ads": {
      "url": "https://meta.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Name	Type	Required	Description
`advertiser_id`	`string`	Required	The advertiser ID from meta_ads_list_tracked_competitors or meta_ads_track_competitorminLength: 1
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (6)

Name	Type	Required	Description
`active_only`	`boolean`	Optional	Only ads still running (no stopped_running_at)
`display_format`	`string`	Optional	Filter by creative format as Meta labels it (case-insensitive). Observed values: image, video, carousel, multi_images, dco, dpa. dco and dpa are Meta's dynamic formats (dynamic creative and catalog/advantage+ ads) and are the most common in the corpus.minLength: 1
`since`	`string`	Optional	Only ads seen on or after this ISO date/timestamp (e.g. 2026-07-01)pattern: ^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z\|[+-]\d{2}:\d{2})?)?$
`search`	`string`	Optional	Case-insensitive search over ad copy (primary text, headline, description)minLength: 1
`limit`	`integer`	Optional	Number of ads per page (default: 20, max: 100)min: 1, max: 100
`cursor`	`string`	Optional	Pagination cursor from previous responseminLength: 1

Examples

Browse all ads

{
  "advertiser_id": "adv-uuid-from-tracked-list",
  "reason": "Review a competitor’s current creative strategy"
}

hopkin meta competitor-ads list --advertiser-id adv-uuid-from-tracked-list

Active video ads

{
  "advertiser_id": "adv-uuid-from-tracked-list",
  "active_only": true,
  "display_format": "video",
  "reason": "Study competitor video creative"
}

hopkin meta competitor-ads list --advertiser-id adv-uuid-from-tracked-list --active-only true --display-format video

New ads this month

{
  "advertiser_id": "adv-uuid-from-tracked-list",
  "since": "2026-08-01",
  "reason": "Find newly launched competitor ads"
}

hopkin meta competitor-ads list --advertiser-id adv-uuid-from-tracked-list --since 2026-08-01

Search ad copy

{
  "advertiser_id": "adv-uuid-from-tracked-list",
  "search": "free shipping",
  "reason": "Find offer-led competitor messaging"
}

hopkin meta competitor-ads list --advertiser-id adv-uuid-from-tracked-list --search free shipping