Generate ads from a store, product, service or app URL
generate_ads_from_urlAds on demand: give the URL of an online store, a single product page, a service business's site, or an App Store / Google Play listing, and get paid-social ads made from the REAL products, prices, reviews and offers on that page (claims are verified against the page; nothing is invented). No brand setup needed. Pro, Scale and Agent plans. Pick the ads ONE of two ways: types (+ optional count, adFormats, animationStyle), or slots: up to 5 ads from the ad format catalog (call list_ad_formats first), each with its own inputs such as a script said word for word. slots can't be combined with types, count, adFormats or animationStyle. SPENDS CREDITS: 1 for reading the site + per ad: static-ad 6 (returns 2 A/B variants), ugc-ad 25, greenscreen-ad 25, animated-ad 37, music-ad 50; a slot costs its format's credits from list_ad_formats (+1 with render). Defaults (no types or slots): a store gets 3 static-ad + 1 ugc-ad (44 credits, 7 ads); a service business or app gets static-ad + ugc-ad + animated-ad (69 credits, 4 ads). Types: static-ad (2 finished image ads in different formats, e.g. review card + benefit callouts, for A/B testing; stores show the real product, service businesses and apps a scene of the service with their real logo), ugc-ad (9:16 presenter talking to camera, ~15s), greenscreen-ad (presenter reacting over a scrolling screenshot of the page), animated-ad (~30s narrated claymation / Pixar-style / felt / cartoon story ad), music-ad (~30s animated music video: a character sings an original song about a relatable moment, the product revealed in the last chorus; the agent picks the genre and look unless prompt asks for one). ASYNC: reading the site takes 15-30s before the jobId returns; generation then takes ~1-3 minutes. Poll get_job. Pass render=true for viewable PNG/MP4 files. Use prompt to steer every ad (theme, audience, angle, and for music-ad the genre or animation look). Billing is per ad: the reservation settles when the job finishes, every ad that wasn't produced (for example no usable product photo) is refunded, and a failed job is refunded in full.
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": {
"url": "<url>"
},
"name": "generate_ads_from_url"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Store home page, product page, service business site, or App Store / Google Play listing. Bare domains work. | |
| name | No | ||
| count | No | Total ads (1-5); repeats the requested types. | |
| slots | No | Ads from the format catalog instead of `types` (up to 5 ads in total). Can't be combined with types, count, adFormats or animationStyle. | |
| types | No | Ad types to make (omit for the default pack). | |
| prompt | No | Free-form creative steer applied to every ad, e.g. 'Halloween theme' or 'target new parents'. | |
| render | No | Also render PNG/MP4 files server-side (+1 credit). | |
| language | No | Language to write the ads in: on-screen text, script and voice-over (ISO 639-1, e.g. 'es', 'de', 'fr'). Defaults to English. The store's facts and reviews are translated when its page is in another language; brand and product names, prices and discount codes stay as on the page. | |
| adFormats | No | Pin the static-ad layouts in order; formats without supporting data are skipped. | |
| adAspectRatio | No | Frame for static-ad (default 4:5). Video ads are always 9:16. | |
| animationStyle | No | Look for animated-ad (else chosen per brand). | |
| presenterImageUrl | No | Optional public image URL of the person (or character) to feature instead of a stock presenter: ugc-ad and greenscreen-ad film them, animated-ad and music-ad draw them in the film's style, and each static-ad decides how to show them. One clear, well-lit photo, at least 256px on the short side. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jobId | Yes | ||
| slots | No | ||
| source | No | ||
| status | Yes | ||
| pollUrl | Yes | ||
| creditsReserved | Yes | ||
| snackTypeSequence | No |