# Adscan, free forever, GET /brandSpy.getTimeline: Facebook Ad Library API

> These are the endpoints for discovering ads and researching competitors across the full AdScan database.

Adscan's Facebook Ad Library API on its Free Forever plan. It costs $0.00 per 1,000 ads. It returns 2 of the 7 key fields we check: Ad status, Run dates.
We haven't run Adscan through [our Facebook Ad Library API benchmark](https://datacircle.dev/best-facebook-ad-library-api.txt) yet.
This plan is free. We rank 118 plans for Facebook Ad Library APIs by price. Half the plans cost $0.494 per 1,000 ads or less.
[Zapi's Rp399,000 monthly plan](https://datacircle.dev/facebook-ad-apis/zapi/rp399000-monthly/llms.txt) is the cheapest paid plan per 1,000 ads: $0.00074. Zapi charges for each page of results. We count 30 ads on each page to get the $0.00074 price.
[Metapi](https://datacircle.dev/facebook-ad-apis/metapi/299-monthly-scale-post-v1-tasks-from-url/llms.txt), [Adyntel](https://datacircle.dev/facebook-ad-apis/adyntel/top-up-from-0-55/llms.txt) and [ScrapeCreators](https://datacircle.dev/facebook-ad-apis/scrapecreators/47-pack/llms.txt) are the best Facebook Ad Library API providers in the Datacircle benchmark.

- This page: https://datacircle.dev/facebook-ad-apis/adscan/free-forever-get-brandspy-gettimeline
- [Facebook Ad Library API: 7 providers compared](https://datacircle.dev/best-facebook-ad-library-api.txt)
- Get it: https://adscan.ai/pricing?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=facebook-ad-library-api-pricing
- Request: `GET https://api.adscan.ai/brandSpy.getTimeline`
- API key: with the plan, on https://adscan.ai/pricing?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=facebook-ad-library-api-pricing
- Its API docs: https://api.adscan.ai/llms.txt?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=facebook-ad-library-api-pricing
- Sold by: Adscan (https://adscan.ai?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=facebook-ad-library-api-pricing)
- Checked: 2026-11-05

## In the answer

- Completeness: 29%
- Ad status: ✓
- Run dates: ✓

## Price

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

## Charges

- Also pays for: nothing else

## Not found

- $ per 1,000: $0.00

## In their words

- Their pitch: These are the endpoints for discovering ads and researching competitors across the full AdScan database.

## Data

- Keep data: no limit
- Use data: You agree to use our service in compliance with all applicable laws. [...] You remain responsible for how you use insights, creatives, or other materials obtained through our service, including compliance with each platform's policies.

## Plan

- Pay: $0

## Rate limit

- Batch: 1

## Speed

- Answer: in the call

## The call

- You send: companyName. Optional: timeRange, dateFrom, dateTo, status, mediaType, language, limit, cursor
- Method: GET
- Path: /brandSpy.getTimeline

## About the plan

- Plan: Free Forever
- Who can get it: anyone

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

ad ID, platform, thumbnail, media types, start date, end date, is active, next cursor, has more

## Adscan's plans (4)

- [Adscan, free forever, GET /brandSpy.getTimeline](https://datacircle.dev/facebook-ad-apis/adscan/free-forever-get-brandspy-gettimeline/llms.txt): $0.00 per 1,000, 29% complete
- [Adscan, $99 monthly, Pro, GET /brandSpy.getTimeline](https://datacircle.dev/facebook-ad-apis/adscan/99-monthly-pro-get-brandspy-gettimeline/llms.txt): 29% complete
- [Adscan, $199 monthly, Team, GET /brandSpy.getTimeline](https://datacircle.dev/facebook-ad-apis/adscan/199-monthly-team-get-brandspy-gettimeline/llms.txt): 29% complete
- [Adscan, $499 monthly, Admanage.ai, GET /brandSpy.getTimeline](https://datacircle.dev/facebook-ad-apis/adscan/499-monthly-admanage-ai-get-brandspy-gettimeline/llms.txt): 29% complete

## Adscan's calls for this API (2)

- `GET /brandSpy.getTimeline`: [Adscan, free forever, GET /brandSpy.getTimeline](https://datacircle.dev/facebook-ad-apis/adscan/free-forever-get-brandspy-gettimeline/llms.txt)
- `GET /publicAds.list`: [Adscan, free forever, GET /publicAds.list](https://datacircle.dev/facebook-ad-apis/adscan/free-forever-get-publicads-list/llms.txt)

## Adscan's APIs (2)

- [Adscan: LinkedIn Ad Library API pricing, 4 plans](https://datacircle.dev/linkedin-ad-apis/adscan/free/llms.txt)
- [Adscan: Facebook Ad Library API pricing, 4 plans, GET /brandSpy.getTimeline](https://datacircle.dev/facebook-ad-apis/adscan/free-forever-get-brandspy-gettimeline/llms.txt)

## Adscan: Facebook Ad Library API alternatives

- [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
- [Adyntel, free](https://datacircle.dev/facebook-ad-apis/adyntel/free/llms.txt): $0.00 per 1,000, 100% complete, live
- [ScrapeCreators, free](https://datacircle.dev/facebook-ad-apis/scrapecreators/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
- [Spytrend, free](https://datacircle.dev/facebook-ad-apis/spytrend/free/llms.txt): $0.00 per 1,000, 57% 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-11-05.

- https://adscan.ai?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=facebook-ad-library-api-pricing
- https://adscan.ai/api-docs?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=facebook-ad-library-api-pricing
- https://adscan.ai/llms.txt?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=facebook-ad-library-api-pricing
- https://adscan.ai/pricing?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=facebook-ad-library-api-pricing
- https://adscan.ai/terms?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=facebook-ad-library-api-pricing
- https://api.adscan.ai/llms.txt?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=facebook-ad-library-api-pricing