Lists LinkedIn Ads entities of any type (LinkedIn Ads tool).
IMPORTANT — LinkedIn UI naming vs API naming:
- LinkedIn UI "Campaigns" = API "campaign_groups" (use entity_type="campaign_groups")
- LinkedIn UI "Ad sets" = API "campaigns" (use entity_type="campaigns")
- LinkedIn UI "Ads" = API "creatives" (use entity_type="creatives")
When a user asks about "campaigns", they usually mean campaign_groups.
entity_type options:
- "campaign_groups": Lists campaigns (LinkedIn UI name). Supports status filter: ACTIVE, PAUSED, ARCHIVED, DRAFT. Supports include_performance with start_date/end_date.
- "campaigns": Lists ad sets (LinkedIn UI name). Supports status filter and campaign_group_id to show ad sets under a specific campaign.
- "creatives": Lists ads (LinkedIn UI name) with format detection (DOCUMENT, VIDEO, SINGLE_IMAGE, CAROUSEL, etc.).
Supports campaign_ids filter and include_content.
IMPORTANT: When status="ACTIVE", auto-filters to only include ads
from ACTIVE ad sets — so you get truly serving ads.
- "conversions": Lists conversion tracking rules. Status filter = enabled_only (pass status="enabled").
- "campaign_conversions": Lists conversion-rule ↔ campaign associations. Requires campaign_ids.
Returns one row per (campaign_id, conversion_id) pairing.
- "lead_forms": Lists lead generation forms. Supports status filter: DRAFT, PUBLISHED, ARCHIVED.
- "saved_audiences": Lists matched/DMP audiences. Paginates fully across the account
(no 10-row cap). Returns the LINKEDIN destination's status as `status` (typical
values: READY, BUILDING, PROCESSING, ARCHIVED, FAILED) plus `destinationSegmentId`
(the `urn:li:adSegment:...` URN to use in targeting criteria). Supports
`name_contains` for client-side substring search (matched audiences are NOT
typeahead-searchable via the LinkedIn API — list and filter is the supported pattern).
- "targeting_audiences": Lists saved targeting audience templates. Supports name_contains.
- "targeting_facets": Lists all available targeting facets/dimensions. No account_id needed.
Args:
entity_type: What to list. One of: campaign_groups, campaigns, creatives, conversions, lead_forms, saved_audiences, targeting_audiences, targeting_facets.
account_id: The LinkedIn Ad Account ID (required for most entity types, not needed for targeting_facets).
status: Optional status filter (meaning varies by entity type). For creatives with status="ACTIVE", cascades through campaign status.
campaign_ids: Optional campaign ID filter (for creatives/ads).
campaign_group_id: Optional campaign group ID filter (for campaigns/ad sets — show ad sets under a specific campaign).
include_content: Include raw content details for creatives. Default: false.
include_performance: Include performance metrics for campaign_groups (requires start_date/end_date). Default: false.
start_date: Start date for performance data (YYYY-MM-DD).
end_date: End date for performance data (YYYY-MM-DD).
limit: Maximum number of results to return. Default: 100.
name_contains: Case-insensitive substring filter on entity name (saved_audiences, targeting_audiences).