Docs · Data · Updated November 12, 2026
Read the Meta ads coaches and course creators are running
LaunchSpy collects the Meta ads of the coaches and course creators it tracks, keeps the creative, and records how long each ad runs. Video ads are transcribed so the hook that is said out loud can be searched.
Questions it answers
- What ads does this competitor run right now?
- Which hooks and angles work in this niche?
- Which ads have run the longest?
- What do coaches say in the first seconds of their video ads?
- Where does each ad send its traffic?
Tools and routes
| MCP tool | REST route | Use |
|---|---|---|
| search_ads | GET /api/v1/ads | Pass creator (a slug) or query (text). Optional: country, language, active. One of creator or query is required. |
Fields returned
| Field | Content |
|---|---|
| copy.headline, copy.body | The written ad. |
| copy.spoken_hook | What is said in the first seconds of the video, when transcribed. |
| copy.cta, copy.cta_type | Call to action. |
| landing_page_url | Where the ad sends its traffic. |
| media.type, media.image_url, media.thumbnail_url, media.video_url | The creative, hosted by LaunchSpy. |
| placement.publisher_platforms | Facebook, Instagram, Messenger, Audience Network. |
| is_active, start_date, end_date, days_running | Status and run length, from the dates published by Meta. |
| eu_total_reach | Unique EU reach published by Meta. Null outside the EU. |
| advertiser.name, advertiser.page_id, ad_library_id, ad_library_url | The advertiser and the link to the ad in the Meta Ad Library. |
How the search works
- query matches the headline, the body copy, the spoken script and the advertiser name.
- country is a market: it is matched through the language of the ad copy.
- active true keeps only the ads running now.