
Foreplay API
foreplay.co
Ads IntelligenceListed, not routed yet
Ad creative library (200M+ ads) with a credit-based public API and MCP.
What it does
Foreplay is a swipe-file and competitor ad research tool for performance creative teams. Its Public API (Spyder brands, ads search and filtering) authenticates with an API key in the Authorization header and bills 1 credit per ad returned.
In its API docs
Pricing
What Foreplay publishes for buying direct, as listed on its own pages.
Buying direct from Foreplay
- API 100,000 Credits$99 /month
- API 250,000 Credits$189 /month
- API 500,000 Credits$349 /month
- App (1 user)$20 per additional user$59 /month
Free tier: 10,000 free credits during trial. Foreplay pricing, checked Sep 29, 2026
Docs
Foreplay's own pages, linked as published.
- API referencedocs.foreplay.co
- OpenAPI specpublic.api.foreplay.co/openapi.json
- Pricingwww.foreplay.co/api
- Websiteforeplay.co
Its OpenAPI document: 22 operations and rate limits
| Method | Path | Summary | Params | Source |
|---|---|---|---|---|
| GET | /api/swipefile/ads | Get user's swipefile ads, all saved ads in swipefile | 15 | Spec |
| GET | /api/boards | List the authenticated user's boards (optionally with folders) | 3 | Spec |
| GET | /api/board/brands | Get all brands for a specific board | 3 | Spec |
| GET | /api/board/ads | Get Ads by board id and Filters | 16 | Spec |
| GET | /api/spyder/brands | Get User's Spyder tracked Brands | 2 | Spec |
| GET | /api/spyder/brand | Get Specific Spyder Brand | 1 | Spec |
| GET | /api/spyder/brand/ads | Get Brand Ads in Spyder | 16 | Spec |
| GET | /api/spyder/brand/rankings/{page_id}/top-overview | Get Spyder Top-Ranked Ads for a Page | 3 | Spec |
| GET | /api/spyder/brand/partners | Get Spyder Related Brands (Partners) for a Page | 2 | Spec |
| GET | /api/spyder/brand/rankings/{page_id}/list | Get Spyder Ranked Ads (Paginated List) for a Page | 4 | Spec |
| GET | /api/ad | Get ad details | 1 | Spec |
| GET | /api/ad/{ad_id} | Get ad details by ID | 1 | Spec |
| GET | /api/ad/duplicates/{ad_id} | Get group of ads using same image or video by ad ID | 1 | Spec |
| GET | /api/brand/getAdsByBrandId | Get Ads by Brand IDs and Filters | 18 | Spec |
| GET | /api/brand/getAdsByPageId | Get Ads by Page ID and Filters | 18 | Spec |
| GET | /api/brand/getBrandsByDomain | Get Brands by Domain | 3 | Spec |
| GET | /api/brand/analytics | Get Brand Analytics by Brand ID or Page ID, gives running ads distribution and creative velocity | 5 | Spec |
| GET | /api/discovery/ads | Search and Filter Ads | 16 | Spec |
| GET | /api/discovery/brands | Search Brands by Name | 5 | Spec |
| GET | /api/discovery/brands/explore | Discover Brands by Ads | 11 | Spec |
| GET | /api/usage | Get user usage information | 0 | Spec |
| GET | /api/lens/reporting | Get reporting data from a lens | 9 | Spec |
Rate limits
Rate limited; 429 Too Many Requests when exceeded (numeric limit not published) Without a published limit GridRouter paces conservatively (1 call per second).
Sources for this page (3)
- Foreplay pricingchecked Sep 29, 2026
- Foreplay APIchecked Sep 29, 2026
- Foreplay Public API docschecked Sep 29, 2026