`linkedin_ads_list_competitor_ads`

List Competitor Ads

Description

List a competitor's ads from the scraped LinkedIn Ad Library corpus — real creative content (copy, CTA, landing URL, media metadata), not just library links. Includes posts from employees' own profiles that the advertiser paid for — each ad says attribution: "advertiser" (its company page) or "payer" (an employee post, with posted_by naming the person). Filter by active_only (still running), display_format (e.g. sponsored_status_update, sponsored_video, sponsored_update_linkedin_article), since (seen on/after a date), and search (full-text over ad copy). Requires no LinkedIn connection — the corpus is maintained by Hopkin's daily scrape of tracked advertisers. Get advertiser IDs from linkedin_ads_list_tracked_competitors or linkedin_ads_track_competitor.

Read-onlyIdempotent

Usage

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

hopkin linkedin competitor-ads list

Flag	Type	Required	Description
`--advertiser-id`	`string`	Required	The advertiser ID from linkedin_ads_list_tracked_competitors or linkedin_ads_track_competitor
`--active-only`	`boolean`	Optional	Only ads still running (no stopped_running_at)
`--display-format`	`string`	Optional	Filter by creative type as recorded from the LinkedIn Ad Library (case-insensitive). Observed values: sponsored_status_update, sponsored_video, sponsored_update_linkedin_article, sponsored_message, sponsored_update_native_document, sponsored_update_event. sponsored_status_update is a single-image post; the vocabulary is LinkedIn’s own and open-ended.
`--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": {
    "linkedin-ads": {
      "url": "https://linkedin.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Name	Type	Required	Description
`advertiser_id`	`string`	Required	The advertiser ID from linkedin_ads_list_tracked_competitors or linkedin_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 type as recorded from the LinkedIn Ad Library (case-insensitive). Observed values: sponsored_status_update, sponsored_video, sponsored_update_linkedin_article, sponsored_message, sponsored_update_native_document, sponsored_update_event. sponsored_status_update is a single-image post; the vocabulary is LinkedIn’s own and open-ended.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 linkedin 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": "sponsored_video",
  "reason": "Study competitor video creative"
}

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

New ads this month

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

hopkin linkedin 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 trial",
  "reason": "Find offer-led competitor messaging"
}

hopkin linkedin competitor-ads list --advertiser-id adv-uuid-from-tracked-list --search free trial