When to use
- “Show me the full config for campaign 1100012345 on Facebook.”
- “What targeting / creative is this ad using?”
list_campaigns, list_adsets, or list_ads.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
source | string | Yes | facebook_ads, google_ads, tiktok_ads, or linkedin_ads. |
level | string | Yes | campaign, adset, or ad. |
id | string | Yes | The platform-side or Cometly id. |
format | string | No | json (default), csv, or yaml. |
Output
JSON object containing every column for the requested entity. Shape varies per platform / level. For Facebook ads, expect fields likeobjective, daily_budget, targeting, creative_id, creative_body, effective_status. For Google ads, expect advertising_channel_type, bidding_strategy_type, final_url, etc.
Caveats
- LinkedIn ad sets don’t have a separate “adset” notion in Cometly’s model — only campaigns and creatives.
level: adsetfor LinkedIn returns a[validation_error]. - Reddit ads only support
level: ad.