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

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

limit

integer

Defaults 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 *	string	Free-text search across ad copy, brand, format.
limit	integer	Defaults to 25, max 100.
confirm_credit_cost	boolean	Set 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 *	string	Target swipe file UUID.
ad_id *	string	Foreplay ad UUID.

Returns

Saved item id and asset_download_status (queued/processing).

Example question

"Save this ad to my Q4 inspiration folder."