Skip to content
GridRouterhome

Search

Search providers, capabilities and pages

Foreplay API

foreplay.co

Verification pendingResearched, not yet routed
Ad creative library (200M+ ads) with a credit-based public API and MCP. Buying direct: API 100,000 credits $99/month; app from $59/month. Listed .
Capabilities
0
From
n/a
Calls, 30 days
0
Ranked first
0 of 0

Overview

Researched from the vendor's own pages; every fact links to its source and the day we checked it.

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.

Company

Legal name
Not confirmed
Headquarters
Not confirmed
Founded
Not confirmed
Employees
Not confirmed
Ownership
Not confirmed
Kind
Data provider
Website
Not confirmed

API

Verified
Access
Self-serve API
Style
REST
Auth
API key (header)
Base URL
https://public.api.foreplay.co
Features
Bulk —Async —Webhooks —MCP YesSandbox —
Rate limit
Not confirmed
Pagination
offset/limit

Pricing

Verified
Model
subscription
List prices
  • API 100,000 Credits $99 /month
  • API 250,000 Credits $189 /month
  • API 500,000 Credits $349 /month
  • App (1 user) $59 /month, $20 per additional user
Currency
USD
Units
credit (1 ad)
Free tier
10,000 free credits during trial
Rollover
No

Compliance

SOC 2
Not confirmed
GDPR
Not confirmed
CCPA
Not confirmed
DPA
Not confirmed
Resale / storage
Unknown until a written agreement says otherwise

Relationships

Integrations
Not confirmed
Alternatives
None named by the vendor
Sources (3)

Placement in the Grid

Where this vendor sits on the GridRouter Grid in each category it serves. No vendor pays for placement.

Placement in the GridRouter Grid by category
CategoryPlacementExecuteCoverageCallsReport
Ads IntelligenceNot yet rated––0View Grid

API

The vendor's OpenAPI document as stored in the catalog, its operations, and the rate limits it publishes.

Official specOpenAPI 3.1.0 · 22 operations Spec (YAML)Vendor'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

No published rate limits found. Without a published limit GridRouter paces conservatively (1 request per second).

Compare Foreplay