Skip to content
Gridlode
Launching soonSocial media and video2 credits / page

Meta Ad Library API

Search Meta's public Ad Library (Facebook, Instagram, Messenger, Audience Network) by keyword or advertiser Page id for any country: ad archive id, advertiser Page, active status, start and end dates, platforms, creative text, headline, link, call to action, image and video URLs, carousel cards, number of versions and, for political and issue ads, the disclosed spend and impression ranges. Returns the first page of results Meta renders for logged-out visitors (up to 30 ads); we never log in and never use Meta access tokens. Meta answers server IPs with a JavaScript challenge, which we never try to pass, so this engine runs through residential proxies. Blocks, failures and empty pages are free.

GEThttps://api.gridlode.com/v1/social/meta/ads
Get an API keyReference docs
This engine is built and is waiting for a terms review of the target site before we switch it on. Join early access through the contact form and we'll email you on launch day.

Parameters

NameTypeDescription
qstringKeyword or advertiser name to search for.
Default: null
page_idstringAdvertiser Facebook Page id, to list that Page's ads (instead of q).
Default: null
countrystring2-letter country code where the ads ran, or 'ALL'.
Default: "ALL"
active_statusstringFilter by delivery status.
Default: "active"
One of: active, inactive, all
ad_typestringAd category. Spend and impressions are disclosed only for political and issue ads.
Default: "all"
One of: all, political_and_issue_ads, housing_ads, employment_ads, credit_ads
media_typestringFilter by creative type ('none' = text-only ads).
Default: "all"
One of: all, image, video, meme, image_and_meme, none
exact_phrasebooleanMatch q as an exact phrase instead of any of its words.
Default: false
limitintegerMaximum ads to return from the first results page.
Default: 30
max_ageintegerAccept a cached answer up to this many seconds old, billed at 50%. Default 0 (always fresh).

Response fields

    Code

    curl "https://api.gridlode.com/v1/social/meta/ads?q=nike&country=US" \
  -H "Authorization: Bearer $GRIDLODE_KEY"
    2 credits per page
    One credit is $0.001 on the smallest pack, from $0.0003 on enterprise plans.
    Half price for cached data
    Cached for up to 6 h. Pass max_age to use it.
    Failed requests are free
    Blocks, timeouts and target errors never cost credits.

    Market reference: Apify Facebook Ads Library scrapers ~$0.75-5 per 1k ads; Meta Ad Library API needs an identity-verified token.

    Questions

    Part of these solutions
    How much does the Meta Ad Library API cost?

    2 credits per page. One credit costs $0.001 on the smallest pack and as little as $0.0003 on enterprise plans. Cached answers cost half and failed calls are free.

    Social media and video

    Related APIs in this category

    All 13 in Social media and video · 7 live
    Live

    YouTube Video Details

    Public metadata of one YouTube video from its watch page, as a signed-out visitor sees it

    1 credit / requestDocs
    Live

    TikTok Profile

    A public TikTok creator or brand profile exactly as a signed-out visitor sees it

    2 credits / requestTry freeDocs
    Live

    YouTube Comments

    Public comments on one YouTube video, in YouTube's Top or Newest order, exactly as a signed-out visitor can load them

    0.05 credits / commentDocs
    Soon

    Facebook Page

    A public Facebook Page (brand, business or organisation) as a logged-out visitor sees it

    2 credits / requestDocs