Meta Ad Status Checker

Check whether any Meta (Facebook/Instagram) ad is active or inactive by its Ad Library ID. Returns full ad metadata including brand, dates, platforms, ad copy, images, videos, and CTA — all from the public Meta Ad Library.

What does Meta Ad Status Checker do?

This actor takes a single Ad Library ID and returns its current status along with complete ad metadata. It's designed for fast, per-use lookups — perfect for monitoring competitor ads, verifying compliance, or building automated ad tracking workflows.

No login or API key required. Everything is scraped from the publicly available Meta Ad Library.

Key Features

• Active/inactive status — Instantly know if an ad is still running
• Full ad metadata — Brand, platforms, dates, ad copy, CTA, images, and videos
• No proxy needed — Calls Facebook's internal API directly via HTTP, no browser or proxy required
• Browser fallback — If the API call fails, automatically falls back to Puppeteer with stealth plugin

Output Data

Each run returns a single result with these fields:

Field	Type	Description
adId	string	The Ad Library ID you looked up
active	boolean	true if the ad is currently running
brand	string	Advertiser / page name
brandLogo	string	URL of the brand's profile image
libraryID	string	Meta Ad Library ID
startDate	string	ISO 8601 date when the ad started running
endDate	string	ISO 8601 date when the ad stopped (empty if still active)
platforms	string[]	Platforms the ad runs on (Facebook, Instagram, Messenger, Audience Network, Threads)
totalPlatforms	number	Number of platforms
body	string	Ad copy / primary text
linkTitle	string	Headline shown in the ad
linkUrl	string	Destination URL
linkDescription	string	Description text below the headline
ctaText	string	Call-to-action button text (e.g. "Shop Now", "Learn More")
ctaUrl	string	Call-to-action destination URL
images	object[]	Array of { url } objects for ad images
videos	object[]	Array of { url, duration } objects for ad videos
format	string	Ad format: image, video, carousel, or unknown
scrapedAt	string	ISO 8601 timestamp of when the data was collected

Sample Output

{
  "adId": "1191898553123641",
  "active": true,
  "brand": "Example Brand",
  "brandLogo": "https://scontent...",
  "libraryID": "1191898553123641",
  "startDate": "2025-01-15T00:00:00.000Z",
  "endDate": "",
  "platforms": ["Facebook", "Instagram"],
  "totalPlatforms": 2,
  "body": "Check out our latest product...",
  "linkTitle": "Shop the Collection",
  "linkUrl": "https://example.com/shop",
  "linkDescription": "Free shipping on orders over $50",
  "ctaText": "Shop Now",
  "ctaUrl": "https://example.com/shop",
  "images": [{ "url": "https://scontent..." }],
  "videos": [],
  "format": "image",
  "scrapedAt": "2025-07-15T12:00:00.000Z"
}

Input Parameters

Parameter	Type	Required	Default	Description
adId	string	Yes	—	The numeric Ad Library ID to check (e.g. 1191898553123641)
country	string	No	ALL	ISO 3166-1 alpha-2 country code to filter by region

How It Works

The actor first tries a direct HTTP API call to Facebook's Ad Library — this is fast (2-5 seconds), uses ~10MB memory, and works without any proxy. If the API call fails, it automatically falls back to a full browser-based scrape using Puppeteer with stealth plugin.

Integrations

This actor can be called via the Apify API, connected to webhooks, or scheduled to run at regular intervals.

Need to check multiple ads at once? Use the companion actor Meta Ad Scraper for bulk scraping from the Meta Ad Library.

Pricing

This actor uses pay-per-event pricing at $0.01 per result. You only pay when the actor successfully returns ad data. Platform costs (compute and proxy) are billed separately by Apify based on your usage.