meta_ads_list_tracked_competitors

List Tracked Competitors

Meta

Description

List the Meta advertisers you are tracking: advertiser name, page ID, when tracking started, last scrape time and status, and the ad count in the corpus for each. Scrape health is flagged per row — advertisers with no successful scrape in the last 48 hours are marked stale, and a non-ok scrape status (blocked, schema_error, empty) carries an explicit scrape_warning; treat flagged rows' corpus data as possibly out of date. Use the returned advertiser IDs with meta_ads_list_competitor_ads to browse their ads. Requires no Meta connection.

Read-onlyIdempotent

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "meta_ads_list_tracked_competitors",
    "arguments": {
      "reason": "Review which competitors are being tracked"
    }
  }
}

Parameters

NameTypeRequiredDescription
reason string Required Why this tool call is neededminLength: 1, maxLength: 500
Optional parameters (2)
NameTypeRequiredDescription
limit integer Optional Number of tracked competitors per page (default: 20, max: 100)min: 1, max: 100
cursor string Optional Pagination cursor from previous responseminLength: 1

Examples

List tracked

{
  "reason": "Review which competitors are being tracked"
}

hopkin meta tracked-competitors list