Ad creative research for AI agents
The ads that kept running are the ones that worked. Your agent can read them.
An advertiser stops paying for a creative that does not work. So the ads that have run for months are the market's own test results. Your agent can pull them from Foreplay and the Meta, TikTok and LinkedIn ad libraries, read the copy and the hook, and read the transcript of the YouTube videos a category keeps watching.
Questions your agent can answer
- Which skincare ads on Meta have run for more than 90 days, and what do their first lines say?
- What formats do the top five meal-kit brands use on TikTok?
- What hooks open the most-viewed YouTube reviews of this product?
The tools it calls
Every row is a tool in the catalogue, with the provider's description and a link to its public reference. Your agent finds them with prowl_search_tools and calls them with prowl_call_tool; each call is billed on its own.
| Tool | Provider | What it returns |
|---|---|---|
foreplay_discovery_ads | Foreplay | Search and discover ads across platforms (Facebook, Instagram, TikTok, YouTube, LinkedIn) using Foreplay. Filter by query, format, platform, niche, date range, and running duration. Returns ad creatives with media URLs, transcriptions, targeting data, emotional drivers, and running duration. Each ad is enriched with: landing_page_url, creative_media_urls (images/videos), facebook_ad_library_url (direct link to view ad), and creative_preview_url (thumbnail). Response includes _url_summary with all deduplicated URLs. Order: newest, oldest, longest_running, most_relevant. Niches: accessories, app/software, beauty, business/professional, education, entertainment, fashion, food/drink, health/wellness, home/garden, jewelry/watches, parenting, pets, real estate, service business, other. Formats: carousel, dco, dpa, event, image, multi_images, multi_videos, video, text. Platforms: facebook, instagram, tiktok, youtube, linkedin, messenger, threads. |
foreplay_brand_analytics | Foreplay | Get analytics data for a specific brand or page over a date range. Automatically determines if the ID is a brand ID or page ID. Returns advertising activity metrics and trends. |
foreplay_get_ads_by_brand_ids | Foreplay | Get ad creatives for one or more brand IDs from Foreplay. Returns full ad data: type, media (images/videos), transcriptions, headlines, descriptions, CTAs, running duration, targeting, emotional drivers, publisher platforms. Each ad is enriched with: landing_page_url, creative_media_urls (all image/video URLs), facebook_ad_library_url (direct link to view ad), creative_preview_url (thumbnail). Response includes _url_summary with all deduplicated URLs. Use brand IDs from foreplay_get_brands_by_domain or foreplay_discovery_brands. Order options: newest, oldest, longest_running, most_relevant. |
meta_ad_library | SearchAPI.io | Meta Ad Library — search Facebook/Instagram ads by keyword or advertiser. View ad creatives, spend, and reach. |
tiktok_ads_library | SearchAPI.io | TikTok Ads Library — search TikTok ads by keyword. View creatives and targeting. |
youtube_search | SearchAPI.io | YouTube Search — search videos by query. Returns titles, channels, views, and publish dates. |
youtube_transcripts | SearchAPI.io | YouTube Transcripts — get video transcript/captions by video ID. |
Two ways to ask
Your agent. Add Prowl to Claude Code, Cursor, Codex or any MCP client with one config block (the getting-started walkthrough has it), then ask in plain language. Under the hood the agent calls, for example, prowl_call_tool with tool_name: "foreplay_discovery_ads".
Prowl Agent. Sign in at prowl.chat and ask the built-in agent the same question. It runs on the same tools and bills the same wallet.
When one call is not enough, ask for a report: Prowl plans the calls, checks numeric claims against independent tools and says what it could not confirm.
What it does not cover
Run length is a signal, not a result: an ad library shows that a creative kept running, not its conversion rate. Prowl finds and reads creatives; it does not generate new ones – that is your agent's job, with this as its evidence.
Frequently asked questions
Does Prowl generate ad creatives?
No. It returns the creatives already running in the market. Your agent can write new ones with those as evidence.
How do I know a creative works?
You don't, from one ad. Days running, variations of the same hook and the number of brands using a format are the signals the data carries.
Which platforms does creative research cover?
Meta, TikTok, LinkedIn and YouTube, plus Foreplay's cross-platform ad index.