List Experiment Ads
list_experiment_adsList the ads inside launched experiments (ad sets), grouped by experiment, with each ad's status in that experiment as the Ads tab shows it, for every channel. Pass experiment_ids (experimentId from search_experiments), campaign_ids, or both (both keeps the given experiments that belong to the given campaigns), and optionally statuses, such as ["PAUSED"] for the ads that are off. status is what the channel last reported: ACTIVE (on), PENDING (on but not serving yet, such as in review, processing or before its start date), PAUSED (off), COMPLETED (ended, or no longer on the channel) or FAILED (the channel reports a problem, such as a disapproval, a deletion or an account hold). An ad switched off inside a running ad set reads PAUSED while the ads still on read ACTIVE. On LinkedIn and Meta a paused or ended ad set or campaign also makes all of its ads read PAUSED or COMPLETED, so compare with the experiment's own status (search_experiments). lastActionReason marks a pause of the ad made in Metadata: MANUAL_PAUSE (by a person) or LOW_PERFORMANCE (by the optimizer); MANUAL_PAUSE_PENDING or LOW_PERFORMANCE_PAUSE_PENDING means the channel has not confirmed that pause yet and the ad may still be running; MANUAL_PAUSE_FAILED means the pause failed and the ad keeps running. An ad with no impressions yet is listed with its own status like any other, so never infer an ad's status from zero impressions. When the call passed no statuses and complete is true, an ad in search_experiments' adIds that is missing here has no status in Metadata: either the channel has not reported it yet or it failed to launch (a SOME_ADS_LAUNCH_FAILED or, on LinkedIn, SOME_CREATIVES_LAUNCH_FAILED issue on the experiment in search_experiments points to the latter, though its absence does not rule a failed launch out), so say so and never report it as running or paused; with statuses, a missing ad may simply be in another status. statusLabel is the Ads tab's chip (Disapproved for an ad Google Ads disapproved, unless it is paused). This is not the library status get_ad_details and search_ads_by_names report. Returns at most 250 ads, newest experiments first; complete=false says some were left out and partial marks an experiment cut short. Read-only.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_experiment_ads"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| statuses | No | Optional: only ads in these statuses, such as ["PAUSED"] for the ads that are off, or every status but COMPLETED to leave ended ads out. | |
| campaign_ids | No | Campaign IDs (wizCampaignId in search_experiments results): lists the ads of every launched experiment in these campaigns. Up to 20. | |
| experiment_ids | No | Experiment (ad set) IDs: experimentId from search_experiments. Up to 50. |