ForeplayVerified

Search & Filter Ads

Search the Foreplay ad index (100M+ ads) with a text query plus filters (live, platform, niche, format, language, duration, date range). Each result in data[] is a full ad object.

foreplayforeplayadsad-intelligencediscoverycreative

Endpoints

1 shown

/apis/v1/foreplay/discovery/ads

GET/apis/v1/foreplay/discovery/ads

Path parameters

This endpoint has no path parameters.

cURL request

curl -X GET "https://api.aisa.one/apis/v1/foreplay/discovery/ads?query=agent%20api&limit=10&cursor=example" \
  -H "Authorization: Bearer $AISA_API_KEY"

Related APIs

Foreplay

Get Ads by Brand IDs

Retrieve ads for one or more known Foreplay brand IDs, applying the same rich filter set as discovery. Each result in data[] is a full ad object.

Foreplay

Get Brands by Domain

Discover brands that advertise from a given domain. Each brand record includes the Foreplay brand_id and the ad_library_id (page_id) used by brand analytics.

Foreplay

Get Brand Analytics

Brand-level running-ads distribution and creative velocity. The id must be a page_id / ad_library_id (from getBrandsByDomain), NOT a Foreplay brand_id — a brand_id returns HTTP 406.