# Foreplay, free: Facebook Ad Library API

> Power AI agents & workflows with competitor ad data

Foreplay's Facebook Ad Library API on its Free trial plan. It costs $0.00 per 1,000 ads. It returns all 7 key fields we check: Ad status, Run dates, Platforms, Text, Media, Call to action, Advertiser.
We rank 26 plans by price. [ScrapeUnblocker's €299 monthly plan](https://datacircle.dev/facebook-ad-apis/scrapeunblocker/299-monthly/llms.txt) costs the least per 1,000 ads: $0.0015. ScrapeUnblocker charges for each page of results. We count 500 ads on each page to get the $0.0015 price.

- This page: https://datacircle.dev/facebook-ad-apis/foreplay/free
- Get it: https://www.foreplay.co/api
- Request: `GET https://public.api.foreplay.co/api/brand/getAdsByPageId`
- API key: with the plan, on https://www.foreplay.co/api
- Its API docs: https://public.api.foreplay.co/docs#tag/brand/GET/api/brand/getAdsByPageId
- Sold by: Foreplay (https://www.foreplay.co)
- Checked: 2026-10-29

## In the answer

- Completeness: 100%
- Ad status: ✓
- Run dates: ✓
- Platforms: ✓
- Text: ✓
- Media: ✓
- Call to action: ✓
- Advertiser: ✓

## Price

- $ per 1,000 ads: $0.00
- Per: result
- Billing: free

## Charges

- Also pays for: nothing else

## Overage

- Units cap: hard

## Not found

- $ per 1,000: $0.00

## In their words

- Their pitch: Power AI agents & workflows with competitor ad data

## Data

- Freshness: stored
- Keep data: 30 days
- Use data: Its API Addendum to the Terms of Service: "Subject to this Addendum and payment of applicable fees, Foreplay grants you a non-exclusive, non-transferable, revocable licence, for the term of your subscription, to access the API and use API Data — including within a product or service you operate for your own customers." [...] "Your customers must access API Data only through your product. You may not issue them API keys or give them direct API access." "You may not: resell, sublicense or provide direct access to the API, share, publish or expose your API key, export the Foreplay index in bulk, except under a separate written agreement, use API Data to create a general-purpose searchable archive of the Foreplay index, represent the Foreplay index as your own database." "You may cache the text and metadata we return — ad copy, transcripts, derived fields — for up to 30 days. Media is different: serve images and video from the URLs we provide rather than copying them into your own storage or CDN." "On termination, you may retain the analysis you have produced. Delete raw API Data within 30 days."

## Plan

- Pay: $0
- You get: 10,000 credits
- Enough for: 10,000 results
- Expires: not carried over

## Rate limit

- Batch: 1

## Speed

- Answer: in the call

## The call

- You send: page_id. Optional: start_date, end_date, order, live, display_format, publisher_platform, niches, market_target, languages, video_duration_min, video_duration_max, running_duration_min_days, running_duration_max_days, cursor, limit, collect, force
- Method: GET
- Path: /api/brand/getAdsByPageId

## About the plan

- Plan: Free trial
- Who can get it: anyone starting a Foreplay 7-day free trial

## The 38 fields the plan's answer can hold

success, credits remaining, credits consumed, Foreplay ad ID, ad archive ID, ad name, Foreplay brand ID, ad text, ad title, call to action text, call to action type, ad categories, creative targeting, languages, market target, niches, product category, timestamped transcription, full transcription, cards, page profile picture, display format, emotional drivers, link URL, is active, persona, publisher platforms, start date, thumbnail, time product was mentioned, ad type, videos, images, content filter, running duration, video duration, Foreplay URL, next cursor

## Foreplay's plans (11)

- [Foreplay, free](https://datacircle.dev/facebook-ad-apis/foreplay/free/llms.txt): $0.00 per 1,000, 100% complete, stored
- [Foreplay, $59 monthly](https://datacircle.dev/facebook-ad-apis/foreplay/59-monthly/llms.txt): $5.90 per 1,000, 100% complete, stored
- [Foreplay, $99 monthly](https://datacircle.dev/facebook-ad-apis/foreplay/99-monthly/llms.txt): $0.99 per 1,000, 100% complete, stored
- [Foreplay, $175 monthly](https://datacircle.dev/facebook-ad-apis/foreplay/175-monthly/llms.txt): $17.50 per 1,000, 100% complete, stored
- [Foreplay, $189 monthly](https://datacircle.dev/facebook-ad-apis/foreplay/189-monthly/llms.txt): $0.756 per 1,000, 100% complete, stored
- [Foreplay, $349 monthly](https://datacircle.dev/facebook-ad-apis/foreplay/349-monthly/llms.txt): $0.698 per 1,000, 100% complete, stored
- [Foreplay, $459 monthly](https://datacircle.dev/facebook-ad-apis/foreplay/459-monthly/llms.txt): $45.90 per 1,000, 100% complete, stored
- [Foreplay, $588 yearly](https://datacircle.dev/facebook-ad-apis/foreplay/588-yearly/llms.txt): $4.90 per 1,000, 100% complete, stored
- [Foreplay, $1,788 yearly](https://datacircle.dev/facebook-ad-apis/foreplay/1788-yearly/llms.txt): $14.90 per 1,000, 100% complete, stored
- [Foreplay, $4,668 yearly](https://datacircle.dev/facebook-ad-apis/foreplay/4668-yearly/llms.txt): $38.90 per 1,000, 100% complete, stored
- [Foreplay, contact us](https://datacircle.dev/facebook-ad-apis/foreplay/contact-us/llms.txt): 100% complete, stored

## Foreplay's calls (1)

- `GET /api/brand/getAdsByPageId`: [Foreplay, free](https://datacircle.dev/facebook-ad-apis/foreplay/free/llms.txt)

## Foreplay's APIs (1)

- [Foreplay: Facebook Ad Library API pricing, 11 plans](https://datacircle.dev/facebook-ad-apis/foreplay/free/llms.txt)

## Foreplay: Facebook Ad Library API alternatives

- [ScrapeCreators, free](https://datacircle.dev/facebook-ad-apis/scrapecreators/free/llms.txt): $0.00 per 1,000, 100% complete, live
- [ScrapeUnblocker, free](https://datacircle.dev/facebook-ad-apis/scrapeunblocker/free/llms.txt): $0.00 per 1,000, 100% complete, live
- [SociaVault, free](https://datacircle.dev/facebook-ad-apis/sociavault/free/llms.txt): $0.00 per 1,000, 100% complete, live
- [Metapi, free, POST /v1/tasks](https://datacircle.dev/facebook-ad-apis/metapi/free-post-v1-tasks/llms.txt): $0.00 per 1,000, 86% complete

## Sources

From each provider's own pricing page and docs, and from what providers tell us. We read this row from these pages on 2026-10-29.

- https://public.api.foreplay.co/docs
- https://public.api.foreplay.co/openapi.json
- https://www.foreplay.co/api
- https://www.foreplay.co/faqs/do-credits-carry-over
- https://www.foreplay.co/faqs/how-are-credits-calculated
- https://www.foreplay.co/faqs/when-do-my-credits-renew
- https://www.foreplay.co/page/api-terms
- https://www.foreplay.co/post/api-launch
- https://www.foreplay.co/pricing