Get Ad Details
adsap_get_adRead ONE ad in full, live from Meta: its creative content (primary texts, headlines, descriptions, CTA, destination link, URL parameters, image hashes / video ids, Facebook Page and Instagram identity) plus status, timestamps, object_story_id / effective_object_story_id (the underlying post, which carries the ad's likes and comments) and the raw creative specs. Get the ad_id from adsap_list_ads or adsap_get_insights. Use it to inspect an ad's copy and media, to replicate an ad, or to answer 'what does this ad say / link to?' and 'what is switched on?'. SETTINGS: creative_summary.enhancements_on lists the enhancements switched on in the creative, the same list Meta shows in its own tools: key, and name (Meta's name, often the key itself). Use those names as returned, never invent others. Switched on means set to on in the creative; whether one actually runs also depends on the ad's eligibility. creative_summary.standard_enhancements_on is Meta's old bundle switch, which Meta leaves out of its own list: mention it only if the user asks. creative_summary.shop: on means Meta can send people to the business's Facebook or Instagram shop instead of the website (product_set_id = the shop's product set); off means people always go to the website. PARTNERSHIP ADS: creative_summary.partnership gives the partner, the account shown second (partner_page_id, partner_instagram_user_id), and Meta's header choice (both_accounts, first_account_only or meta_picks; null means nothing was set, which Meta shows as both accounts). The account shown first is the ad's own page_id / instagram_user_id. creative_status is Meta's status of the creative: WITH_ISSUES means Meta will not deliver it as it is, IN_PROCESS means Meta is still checking it, so read the ad again in a minute. EARLIER VERSIONS: every edit of an ad's text or media gives it a new creative and keeps the old one. creative_history lists the edits made through Adsap, newest first (when, web app or Claude, previous and new creative id); edits made in Ads Manager are in Meta's change log (adsap_get_account_activities, creative change events carry the old and new creative id). To read an earlier version, pass its id as creative_id: it comes back in older_creative, in the same shape as the current one. Only creatives of the same ad account are read. Read-only: to CHANGE a live ad's creative use adsap_replace_ad_creative.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ad_account_id": "<ad_account_id>",
"ad_id": "<ad_id>"
},
"name": "adsap_get_ad"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ad_id | Yes | Ad ID (numeric). Get it from adsap_list_ads. | |
| creative_id | No | Optional. The id of an earlier creative of this ad (from creative_history, or from the creative change events of adsap_get_account_activities) to read that version too. It comes back in older_creative. A creative of another ad account is refused (NOT_FOUND). | |
| ad_account_id | Yes | Ad account ID (act_xxx) the ad belongs to. Required. Scopes the request and anchors the Meta budget check. |