Get creative media (download URLs)
get_mediaFetch downloadable creative MEDIA (image/video URL + thumbnail) for 1-500 ad or creative UUIDs returned by search_ads / search_creatives. This is the paid delivery step. entity_type is 'ad' or 'creo'. Existing clients keep the {entity_type,items:[{id,media:[{media_type,url,thumbnail_url,fallback_urls}]}]} fields; additive counts, partial and failures explain malformed, quota-limited and unavailable items, plus interrupted items when at least one peer was delivered. Malformed/zero UUIDs never reach the API or consume quota; valid peers in a mixed batch are still processed. duplicate_count reports canonical duplicates, which are fetched and billed once. IMPORTANT: a media URL can become unavailable, so if url returns an HTTP error (e.g. 416/404), retry fallback_urls in order before treating it as unavailable. Typical flow: search_ads (browse metadata, 1 MCP credit per row) → pick ids → get_media. QUOTA: 50 MCP credits per delivered multilang-upload ad, 1 per ordinary ad, 10 per creative-catalogue item (free starter: 500 MCP credits total; paid plans: 40,000/month). The ad price is per returned ad, not per media file. Actual ad membership determines the price even without a preceding filtered search. Every new call is billed; get_ad already includes media, so do not call get_media again for files you already received. Invalid, missing or undelivered items are not charged. Mixed batches examine a quota-bounded prefix and return affordable items with explicit failures for the rest; an unexamined tail may contain affordable ordinary ads, which can be requested separately. get_usage is free. MULTILANG CONTENT: get_ad and get_media(ad) use the same full detail carousel. primary_creative identifies its selected first creative; primary_creative_selection.status describes selected, fallback or unavailable. carousel_position is the original 1-based carousel position, not the returned array index. Missing/unconfirmed selected primary media is not charged or disclosed; both tools report primary_creative_unavailable. Per-slide title/body/link_url describe that slide; when the API omits a slide override, the ad-level value is supplied as its fallback, consistently in both tools. original_landing_domain describes the original ad, while creative_destination_url/domain describe the primary creative's destination. cloaking_detected is a detected domain/copy mismatch, not a verified redirect or a guarantee that a creative is black. Actual per-call debit is reported in _meta.billing.tokens_charged, in Spytrend quota MCP credits (not model tokens); admin may be exempt. PRICING: on paid plans ×1 after 500 MCP credits/month; one-time consent via accept_pricing_terms; before calling, get the maximum debit from estimate_cost (free) and tell the user.
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": {
"entity_type": "<entity_type>",
"ids": "<ids>"
},
"name": "get_media"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | 1 to 500 ad or creative UUIDs to resolve (from search_ads / search_creatives results); malformed ids are reported per item and never consume quota | |
| entity_type | Yes | what kind of media to fetch: 'ad' (creative media of ads from search_ads) or 'creo' (media of creatives from search_creatives) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present only when isError is true: machine-readable failure. The human explanation stays in content. | |
| items | No | ||
| params | No | Request parameter echo: applied = parameters that shaped this result; normalized = parameters rewritten before applying (alias, type coercion, resolved id); ignored = parameters that were accepted but NOT applied, with the reason. | |
| partial | No | ||
| failures | No | ||
| addon_hints | No | Add-on modules that have additional data for objects of this result (no prices, no paid values). subscription_status=active: the account has the module — use its normal path. Do not push a purchase the user did not ask about. | |
| entity_type | No | ||
| valid_count | No | ||
| attempted_count | No | ||
| delivered_count | No | ||
| duplicate_count | No | ||
| requested_count | No |