Skip to content
GridRouterhome

Search

Search providers, capabilities and pages

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.

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.

Its OpenAPI document: 22 operations and rate limits
Official specOpenAPI 3.1.0 · 22 operations Spec (YAML)Provider's spec
Operations in the foreplay spec
MethodPathSummaryParamsSource
GET/api/swipefile/adsGet user's swipefile ads, all saved ads in swipefile15Spec
GET/api/boardsList the authenticated user's boards (optionally with folders)3Spec
GET/api/board/brandsGet all brands for a specific board3Spec
GET/api/board/adsGet Ads by board id and Filters16Spec
GET/api/spyder/brandsGet User's Spyder tracked Brands2Spec
GET/api/spyder/brandGet Specific Spyder Brand1Spec
GET/api/spyder/brand/adsGet Brand Ads in Spyder16Spec
GET/api/spyder/brand/rankings/{page_id}/top-overviewGet Spyder Top-Ranked Ads for a Page3Spec
GET/api/spyder/brand/partnersGet Spyder Related Brands (Partners) for a Page2Spec
GET/api/spyder/brand/rankings/{page_id}/listGet Spyder Ranked Ads (Paginated List) for a Page4Spec
GET/api/adGet ad details1Spec
GET/api/ad/{ad_id}Get ad details by ID1Spec
GET/api/ad/duplicates/{ad_id}Get group of ads using same image or video by ad ID1Spec
GET/api/brand/getAdsByBrandIdGet Ads by Brand IDs and Filters18Spec
GET/api/brand/getAdsByPageIdGet Ads by Page ID and Filters18Spec
GET/api/brand/getBrandsByDomainGet Brands by Domain3Spec
GET/api/brand/analyticsGet Brand Analytics by Brand ID or Page ID, gives running ads distribution and creative velocity5Spec
GET/api/discovery/adsSearch and Filter Ads16Spec
GET/api/discovery/brandsSearch Brands by Name5Spec
GET/api/discovery/brands/exploreDiscover Brands by Ads11Spec
GET/api/usageGet user usage information0Spec
GET/api/lens/reportingGet reporting data from a lens9Spec

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)