June Offer Every MAX plan gets a fully custom-built system Free custom system worth $1,500-$10,000 · worth $1,500-$10,000
Browse modules
Overview/Ads & intel

Foreplay ad library

3 read2 write

Foreplay ad-library search, brand / ad detail and personal swipe files.

Detailed reference

get_brand_adsreadforeplay.view_library

All ads for a specific brand. Provide one of brand_id, page_id, or domain.

Parameters
brand_idstring?Foreplay brand UUID.
page_idstring?Meta page ID.
domainstring?Brand domain (e.g. nike.com).
Returns

Page of ads with id, headline, body, network, status, last_seen_at.

Example question

"Show me every active ad from brand X."

list_my_foreplay_swipe_filesreadforeplay.view_library

Your saved Foreplay swipe files.

Parameters
limitintegerDefaults to 25.
Returns

Per file: id, name, ad_count, updated_at.

Example question

"What's in my Foreplay swipe files?"

search_adsreadforeplay.view_library

Search the Foreplay ad library by keyword. DB-cached queries are free; live API queries cost 1 credit per ad and require explicit confirmation.

Parameters
query *stringFree-text search across ad copy, brand, format.
limitintegerDefaults to 25, max 100.
confirm_credit_costbooleanSet true to authorise live API. Defaults false (DB-only).
Returns

Per ad: id, brand, headline, body, image_url, video_url, network, started_at.

Example question

"Find DTC skincare ads using UGC video."

save_ad_to_foreplay_swipe_filewriteforeplay.save_ads

Save an ad to a Foreplay swipe file. Asset download (image/video) happens asynchronously in the background.

Parameters
swipe_file_id *stringTarget swipe file UUID.
ad_id *stringForeplay ad UUID.
Returns

Saved item id and asset_download_status (queued/processing).

Example question

"Save this ad to my Q4 inspiration folder."

More tools

1
  • create_foreplay_swipe_filewrite