The PixelSpyer API

Pull ads and advertiser data into dashboards, spreadsheets, Slack bots or your own product. JSON over HTTPS, authenticated with a personal key. Available on the Agency plan.

Authentication

Create a key in Settings → API keys and send it in the Authorization header on every request. Responses are wrapped as { ok: true, data: … }.

Authorization: Bearer ps_live_xxxxxxxxxxxxxxxxxxxxxxxx

Errors and limits

60 requests per minute per key; daily quota by plan (Agency: 5,000 calls).
Errors return { ok: false, error: { code, message } } with HTTP 400, 401, 402, 404 or 429.
Counts above 10,000 are capped and flagged with capped: true.

GET/api/v1/ads

Search ads

`q`	Keywords in the ad copy (supports quotes, OR and -exclusions)
`scope`	all (default), brand or domain
`status`	active or inactive
`niche`	Comma-separated niche slugs, e.g. skincare,fashion
`country`	Comma-separated country names, e.g. Germany,France
`platform`	facebook, instagram, messenger, threads, audience_network
`media`	video, image, carousel, text
`cta`	Call-to-action label, e.g. Shop now
`since`	24h, 7d, 30d, 90d, 6m, 1y
`minDays / maxDays`	Run-time window in days
`minCountries`	Minimum number of delivery countries
`preview`	only = ads with captured creatives (default all for the API)
`sort`	newest, oldest, longest, reach, likes, relevance
`page / per_page`	Pagination (per_page max 60)

curl -H "Authorization: Bearer $PIXELSPYER_KEY" \
  "https://pixelspyer.com/api/v1/ads?q=%22free%20shipping%22&status=active&minDays=30&per_page=5"

GET/api/v1/ads/{id}

Get one ad

`id`	Meta Ad Library ID

curl -H "Authorization: Bearer $PIXELSPYER_KEY" https://pixelspyer.com/api/v1/ads/1024218063490791

GET/api/v1/advertisers

List advertisers

`q`	Name contains
`niche`	Niche slug
`country`	Country name in top markets
`sort`	active, ads, recent, likes, name, video
`page / per_page`	Pagination (per_page max 100)

curl -H "Authorization: Bearer $PIXELSPYER_KEY" "https://pixelspyer.com/api/v1/advertisers?niche=skincare&sort=active"

GET/api/v1/advertisers/{pageId}

Advertiser profile and insights

pageId Facebook page ID

curl -H "Authorization: Bearer $PIXELSPYER_KEY" https://pixelspyer.com/api/v1/advertisers/100556499722298

GET/api/v1/advertisers/{pageId}/ads

Ads by an advertiser

`pageId`	Facebook page ID
`…`	Any /ads filter

curl -H "Authorization: Bearer $PIXELSPYER_KEY" "https://pixelspyer.com/api/v1/advertisers/100556499722298/ads?status=active"

GET/api/v1/me

Your plan and usage

curl -H "Authorization: Bearer $PIXELSPYER_KEY" https://pixelspyer.com/api/v1/me

Build on the ad library

Agency plans include API access with 5,000 calls a day.

See the Agency plan