Our Meta Ad Library API allows you to scrape ads from the Meta Ad Library, the library of the ads shown on Meta's technologies: Facebook, Instagram, Messenger, WhatsApp, Threads, and the Audience Network. For each ad, the API returns its Library ID, whether it's still running, when it started and stopped running, its platforms, the page it appears from, its texts, images, and videos, the cards of carousels and the versions of dynamic ads, and its call to action. Ads about social issues, elections or politics also have their spend, impressions, estimated audience size, and who paid for them.

Search ads by keywords with q, or get the ads of an advertiser with page_id, with the Ad Library's filters: country, ad category, active status, media type, platforms, languages, and date range. Each page has up to 30 ads, and next_page_token gets the next ones.


The API endpoint is https://serpapi.com/search?engine=meta_ad_library

Head to the playground for a live and interactive demo.

API Parameters

Search Query

q

Optional

Parameter defines the keyword to search ads for, like a keyword search in the Ad Library (e.g., coffee or running shoes). It returns the ads that match the keyword, whatever their advertiser: to get the ads of an advertiser, use page_id.

Either q or page_id should be set. They can also be used together to get the advertiser's ads that match the keyword.

Advertiser

page_id

Optional

Parameter defines the Facebook page ID of the advertiser whose ads you want to get (e.g., 15087023444 for Nike). Page IDs are available in page_id of the ads in the results.

Either q or page_id should be set. They can also be used together to get the advertiser's ads that match the keyword.

Localization

country

Optional

Parameter defines the country where the ads were shown. It's a two-letter country code (e.g., US for the United States, or DE for Germany), or ALL (default) for all countries. Head to the Meta Ad Library countries page for a full list of supported countries.

Advanced Filters

search_type

Optional

Parameter defines the type of keyword search. It can be set to keyword_unordered (default) to search for the words of the query in any order, or keyword_exact_phrase to search for the query as an exact phrase.

ad_type

Optional

Parameter defines the category of the ads. It defaults to all.

Available options:
all - All ads
political_and_issue_ads - Issues, elections or politics
housing_ads - Housing
employment_ads - Employment
financial_products_and_services_ads - Financial products and services

The Ad Library doesn't offer political_and_issue_ads in the countries of the European Union, where it returns no ads. Their ads about social issues, elections or politics are in the results of all.

active_status

Optional

Parameter defines whether the ads are still running. It defaults to active.

Available options:
active - Active ads
inactive - Inactive ads
all - Active and inactive ads

media_type

Optional

Parameter defines the type of media of the ads. It defaults to all.

Available options:
all - All media types
image - Images
meme - Memes
image_and_meme - Images and memes
video - Videos
none - No image or video

publisher_platforms

Optional

Parameter defines the platforms the ads were shown on. It's a comma-separated list of platforms (e.g., facebook,instagram). It defaults to all platforms.

Available options:
facebook - Facebook
instagram - Instagram
audience_network - Audience Network
messenger - Messenger
whatsapp - WhatsApp
threads - Threads

content_languages

Optional

Parameter defines the languages of the ads. It's a comma-separated list of two-letter language codes (e.g., en for English, or en,es for English and Spanish). It defaults to all languages.

start_date

Optional

Parameter defines the start of the date range of the ads, in the YYYY-MM-DD format (e.g., 2026-01-01). Like the Ad Library's impressions by date filter, it returns the ads shown during the date range, whenever they started running. It can't be in the future.

end_date

Optional

Parameter defines the last day of the date range of the ads, in the YYYY-MM-DD format (e.g., 2026-03-31).

sort_by

Optional

Parameter defines the sorting of the results. It defaults to impressions_high_to_low, like the Ad Library.

Available options:
most_recent - Most recent
impressions_high_to_low - Impressions: high to low
impressions_low_to_high - Impressions: low to high

The Ad Library only offers impressions_low_to_high for ads about social issues, elections or politics, the only ads it shows the impressions of.

Pagination

next_page_token

Optional

Parameter defines the next page token. It is used for retrieving the next page results. Each page has up to 30 results, like the Ad Library.

The next page token can be found in the SerpApi JSON response: serpapi_pagination -> next_page_token

Serpapi Parameters

engine

Required

Set parameter to meta_ad_library to use the Meta Ad Library API engine.

no_cache

Optional

Parameter will force SerpApi to fetch the Meta Ad Library results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.

async

Optional

Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.

zero_trace

Optional

Enterprise only. Parameter enables ZeroTrace mode. It can be set to false (default) or true. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.

api_key

Required

Parameter defines the SerpApi private key to use.

output

Optional

Parameter defines the format of the result. It can be set to json (default) to get a structured JSON of the results, html to get the raw HTML retrieved, or md to get a markdown-formatted version optimized for LLMs and AI agents.

json_restrictor

Optional

Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details.

API Results

JSON Results

JSON output includes structured data for Ads and Advertiser.

A search status is accessible through search_metadata.status. It flows this way: Processing -> Success || Error. If a search has failed, error will contain an error message. search_metadata.id is the search ID inside SerpApi.

HTML Results

This API does not have a full HTML response, only text. search_metadata.prettify_html_file contains a link to the prettified version of the result. It is displayed in the playground.

Markdown Results

Markdown output is optimized for LLMs and AI agents. It provides a curated view of the JSON results in a token-efficient format using tables, markdown links, and YAML frontmatter.

To access, use the output=md parameter, the /search.md endpoint, or request header Accept: text/markdown.

API Examples

Result for  q: nike

By default, the API searches the active ads of all categories, shown in all countries. search_information.total_results is the number of ads found, up to 50,001 (more than 50,000, as shown by the Ad Library). The links to images and videos are links to Facebook's CDN, which expire after a few days.

Result for  q: nike Result for  q: nike

JSON Example

{
  ...
  "ads": [
    {
      "position": 1,
      "ad_archive_id": "1702938977100376",
      "details_link": "https://www.facebook.com/ads/library/?id=1702938977100376",
      "is_active": true,
      "start_date": "2025-04-07",
      "publisher_platforms": [
        "facebook",
        "instagram",
        "audience_network",
        "messenger"
      ],
      "page_id": "15087023444",
      "page_name": "Nike",
      "page_profile_link": "https://www.facebook.com/nike/",
      "page_profile_picture": "https://scontent-dfw5-2.xx.fbcdn.net/v/t39.35426-6/431756959_712871054375981_2401799800446082357_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=SPawpmTJ8ksQ7kNvwHXhZAg&_nc_oc=AdpqajbKwdOHyjz5-Z8NspqXR4od7iPhJR4PpeohdA_vWAcVER3Uhhf9_akTy4ibuozaBktmSZanQts4PUtkFdKE&_nc_zt=14&_nc_ht=scontent-dfw5-2.xx&_nc_gid=5GMY2Pnmc5UE9LqQQ5gaJQ&_nc_ss=7b289&oh=00_AQO9OELtnoEjEZVTs0zYtHv8ytDU8qvDa4bxI0bdd5nMfg&oe=6AD2D306",
      "page_likes": 39504574,
      "page_categories": [
        "Sportswear",
        "Product/service"
      ],
      "display_format": "dpa",
      "body": "Bring sports more fully into your day with the Nike App.",
      "caption": "itunes.apple.com",
      "link": "http://itunes.apple.com/app/id1095459556",
      "call_to_action": "Install now",
      "call_to_action_type": "INSTALL_MOBILE_APP",
      "cards": [
        {
          "title": "Nike Invincible 3 Women's Road Running Shoes",
          "body": "Bring sports more fully into your day with the Nike App.",
          "caption": "itunes.apple.com",
          "link": "https://www.nike.com/ph/t/invincible-3-road-running-shoes-LL61DX/DR2660-001",
          "link_description": "₱9,895",
          "call_to_action": "Install Now",
          "call_to_action_type": "INSTALL_MOBILE_APP",
          "original_image": "https://scontent-dfw6-1.xx.fbcdn.net/v/t39.35426-6/431631323_928727432024463_5606595664509361185_n.jpg?_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=WO6lEzyhqpwQ7kNvwGGUZFJ&_nc_oc=Ado-f2CYAlj1xOYMQ9Yd4yhja4kFWomnNhS-Jj041QVB2ZHNY8s7qVeEApMiGKW-RiSL4gX0HtLERWfVZdXQr9sy&_nc_zt=14&_nc_ht=scontent-dfw6-1.xx&_nc_gid=5GMY2Pnmc5UE9LqQQ5gaJQ&_nc_ss=7b289&oh=00_AQPBxAG3_zc5RGrJPgIaDsCGfFlARCqy38PrWEon855F7w&oe=6AD2B467",
          "resized_image": "https://scontent-dfw6-1.xx.fbcdn.net/v/t39.35426-6/431631323_928727432024463_5606595664509361185_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=WO6lEzyhqpwQ7kNvwGGUZFJ&_nc_oc=Ado-f2CYAlj1xOYMQ9Yd4yhja4kFWomnNhS-Jj041QVB2ZHNY8s7qVeEApMiGKW-RiSL4gX0HtLERWfVZdXQr9sy&_nc_zt=14&_nc_ht=scontent-dfw6-1.xx&_nc_gid=5GMY2Pnmc5UE9LqQQ5gaJQ&_nc_ss=7b289&oh=00_AQM51DqzqFBAQnbzPLBOhOHQcwp3IGQoEzM-Xya_0HD5_A&oe=6AD2B467"
        },
        {
          "title": "Nike Dri-FIT Icon Men's Basketball Jersey",
          "body": "Bring sports more fully into your day with the Nike App.",
          "caption": "itunes.apple.com",
          "link": "https://www.nike.com/ph/t/dri-fit-icon-basketball-jersey-4Z5f8P/DV9968-010",
          "link_description": "₱1,695",
          "call_to_action": "Install Now",
          "call_to_action_type": "INSTALL_MOBILE_APP",
          "original_image": "https://scontent-dfw5-1.xx.fbcdn.net/v/t39.35426-6/431718739_3499889103593675_2072398184202305018_n.jpg?_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=GXvkDhIbjJMQ7kNvwFd9hdd&_nc_oc=AdqeMdomfEeN1401jwI2-Z8N2SDEduGOlabk9cFNQJwXGImi2DSL9bA3xfk5DMUVpEcKM99W9QgdBzsAQztYSbU0&_nc_zt=14&_nc_ht=scontent-dfw5-1.xx&_nc_gid=5GMY2Pnmc5UE9LqQQ5gaJQ&_nc_ss=7b289&oh=00_AQP2E_TT1C5LM7pzDRmH0TbtVUBXM1aG4_4nI8MWRMSg2w&oe=6AD2C702",
          "resized_image": "https://scontent-dfw5-1.xx.fbcdn.net/v/t39.35426-6/431718739_3499889103593675_2072398184202305018_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=GXvkDhIbjJMQ7kNvwFd9hdd&_nc_oc=AdqeMdomfEeN1401jwI2-Z8N2SDEduGOlabk9cFNQJwXGImi2DSL9bA3xfk5DMUVpEcKM99W9QgdBzsAQztYSbU0&_nc_zt=14&_nc_ht=scontent-dfw5-1.xx&_nc_gid=5GMY2Pnmc5UE9LqQQ5gaJQ&_nc_ss=7b289&oh=00_AQPDg-jkxHghcun5S6MxHLJ_yuSYsBTDQayzXK9e8whs3A&oe=6AD2C702"
        },
        ...
      ]
    },
    {
      "position": 2,
      "ad_archive_id": "1559738104701476",
      "details_link": "https://www.facebook.com/ads/library/?id=1559738104701476",
      "is_active": true,
      "start_date": "2025-04-25",
      "publisher_platforms": [
        "facebook",
        "instagram",
        "audience_network",
        "messenger"
      ],
      "page_id": "15087023444",
      "page_name": "Nike",
      "page_profile_link": "https://www.facebook.com/nike/",
      "page_profile_picture": "https://scontent-dfw5-2.xx.fbcdn.net/v/t39.35426-6/400027547_358739853502630_8144226094621458298_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Qv0fic6IlE0Q7kNvwHLmdI-&_nc_oc=AdplQBUnTLupQ64LTI6y-NRiJ6H941HsxifqaOs4nuHR5vqffu8hO0nTsvm15nwI-4bLYH-M4Niy5LHtIflVEoJ4&_nc_zt=14&_nc_ht=scontent-dfw5-2.xx&_nc_gid=5GMY2Pnmc5UE9LqQQ5gaJQ&_nc_ss=7b289&oh=00_AQNN6wX9hXRDE_uer0jSGEW_8etJ0gT0ghHkKfiIKA2Izw&oe=6AD2C3B7",
      "page_likes": 39504574,
      "page_categories": [
        "Sportswear",
        "Product/service"
      ],
      "display_format": "dpa",
      "body": "Encuentra tu mejor estilo.\nLlegó el momento de que disfrutes los beneficios que la Nike App tiene para ti 😎. ¡Descárgala ahora!",
      "caption": "play.google.com",
      "link": "http://play.google.com/store/apps/details?id=com.nike.omega",
      "call_to_action": "Install now",
      "call_to_action_type": "INSTALL_MOBILE_APP",
      "cards": [
        {
          "title": "Shorts Dri-FIT de 18 cm versátiles sin forro para hombre Nike Form - Negro",
          "body": "Encuentra tu mejor estilo.\nLlegó el momento de que disfrutes los beneficios que la Nike App tiene para ti 😎. ¡Descárgala ahora!",
          "caption": "play.google.com",
          "link": "https://www.nike.com/mx/t/shorts-dri-fit-de-18-900-versátiles-sin-forro-form-1Kl48s?cp=54413048966_soc_",
          "link_description": "$854",
          "call_to_action": "Install Now",
          "call_to_action_type": "INSTALL_MOBILE_APP",
          "original_image": "https://scontent-dfw6-1.xx.fbcdn.net/v/t39.35426-6/399960590_1003889420725694_6884301960231990928_n.jpg?_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=PeSeNCe1EywQ7kNvwFlEGjf&_nc_oc=AdoNDp_R4PrFZOvVemd8A1WKaD3rPbpcZUgJnqNjvWnHYk2H3CUQ_XClBtDjhhYJ7l5LNyCMFlcspIR3VgbLq8sW&_nc_zt=14&_nc_ht=scontent-dfw6-1.xx&_nc_gid=5GMY2Pnmc5UE9LqQQ5gaJQ&_nc_ss=7b289&oh=00_AQMWbo9-1jonGUruRJMzsVO3nrhA7939wSAQnfLvKyeDKA&oe=6AD2BA91",
          "resized_image": "https://scontent-dfw6-1.xx.fbcdn.net/v/t39.35426-6/399960590_1003889420725694_6884301960231990928_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=PeSeNCe1EywQ7kNvwFlEGjf&_nc_oc=AdoNDp_R4PrFZOvVemd8A1WKaD3rPbpcZUgJnqNjvWnHYk2H3CUQ_XClBtDjhhYJ7l5LNyCMFlcspIR3VgbLq8sW&_nc_zt=14&_nc_ht=scontent-dfw6-1.xx&_nc_gid=5GMY2Pnmc5UE9LqQQ5gaJQ&_nc_ss=7b289&oh=00_AQN3lOOu_MjuyJm41goz-EPdDJWOIotH8Ei59Aqxe9wm4w&oe=6AD2BA91"
        },
        {
          "title": "Calzado para mujer Nike Air Force 1 '07 - Blanco",
          "body": "Encuentra tu mejor estilo.\nLlegó el momento de que disfrutes los beneficios que la Nike App tiene para ti 😎. ¡Descárgala ahora!",
          "caption": "play.google.com",
          "link": "https://www.nike.com/mx/t/calzado-air-force-1-07-WGq1wQ?cp=54413048966_soc_",
          "link_description": "$2,294",
          "call_to_action": "Install Now",
          "call_to_action_type": "INSTALL_MOBILE_APP",
          "original_image": "https://scontent-dfw5-1.xx.fbcdn.net/v/t39.35426-6/400057885_876651337399777_1711677532442992421_n.jpg?_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=kJzqQXAvtsQQ7kNvwEtRh3q&_nc_oc=Adr7EHXL0MAcnhwAWXEHNwgK8GLJ2jlDShkkIT3NUF7uEUc2K53JNftrc-fFvJ-pTO1ApfQ_4zXIAYy1ij7-eZKa&_nc_zt=14&_nc_ht=scontent-dfw5-1.xx&_nc_gid=5GMY2Pnmc5UE9LqQQ5gaJQ&_nc_ss=7b289&oh=00_AQNgi4SV2qmAqg6IhXtR5mff8ftsGWcj_LBxycma9_H3Kw&oe=6AD2DE6A",
          "resized_image": "https://scontent-dfw5-1.xx.fbcdn.net/v/t39.35426-6/400057885_876651337399777_1711677532442992421_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=kJzqQXAvtsQQ7kNvwEtRh3q&_nc_oc=Adr7EHXL0MAcnhwAWXEHNwgK8GLJ2jlDShkkIT3NUF7uEUc2K53JNftrc-fFvJ-pTO1ApfQ_4zXIAYy1ij7-eZKa&_nc_zt=14&_nc_ht=scontent-dfw5-1.xx&_nc_gid=5GMY2Pnmc5UE9LqQQ5gaJQ&_nc_ss=7b289&oh=00_AQMtYM4jpmNVHErpZvMBnyzFRqF2nz5IsZdL2f_x7d2OGQ&oe=6AD2DE6A"
        },
        ...
      ]
    },
    ...
  ],
  "serpapi_pagination": {
    "next_page_token": "AQHT3_oqv1FGQC09iceOECvXEwTAqpCNvlBi3JV9IwhKjlR0TOaDgubNxBEDg3cV2itn",
    "next": "https://serpapi.com/search.json?country=ALL&engine=meta_ad_library&next_page_token=AQHT3_oqv1FGQC09iceOECvXEwTAqpCNvlBi3JV9IwhKjlR0TOaDgubNxBEDg3cV2itn&q=nike"
  }
}

Result for  page_id: 15087023444

page_id gets the ads of an advertiser, from the ID of its Facebook page, available in page_id of the ads in the results. The advertiser block has the name, the link, and the profile picture of its page. With q, only the advertiser's ads that match the keyword are returned.

Ads in partnership with a brand appear from the page of a creator, with the brand in branded_content.

Result for  page_id: 15087023444

JSON Example

{
  ...
  "advertiser": {
    "page_id": "15087023444",
    "name": "Nike",
    "link": "https://facebook.com/nike",
    "profile_picture": "https://scontent.xx.fbcdn.net/v/t39.30808-1/284964043_10159903868513445_7696353984967674128_n.jpg?stp=dst-jpg_s148x148_tt6&_nc_cat=102&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=418b77&_nc_ohc=tqrtwljSaX0Q7kNvwGWg9eI&_nc_oc=AdqkZ2tOoWmcQmC_XHlxNB6d7enAqtRKvjowu07wueE-7cgZPefPinL263HPH2W04SY&_nc_zt=24&_nc_ht=scontent.fagc1-2.fna&_nc_gid=GQQvB9fvdDdRcBJTzMh3GA&_nc_ss=7b289&oh=00_AQOoHpYuHbCyRy_6FZ-BoJINbt0SwuPB5J2lc62E8wHNkg&oe=6AD2D130"
  },
  "ads": [
    {
      "position": 1,
      "ad_archive_id": "1702938977100376",
      "details_link": "https://www.facebook.com/ads/library/?id=1702938977100376",
      "is_active": true,
      "start_date": "2025-04-07",
      "publisher_platforms": [
        "facebook",
        "instagram",
        "audience_network",
        "messenger"
      ],
      "page_id": "15087023444",
      "page_name": "Nike",
      "page_profile_link": "https://www.facebook.com/nike/",
      "page_profile_picture": "https://scontent.xx.fbcdn.net/v/t39.35426-6/431756959_712871054375981_2401799800446082357_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=104&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=SPawpmTJ8ksQ7kNvwGcnsOb&_nc_oc=AdoHKQTDGQryXO2-BLVcRhfQGhfiNcuUWrOH0S44oK6KcNuC8W8xHWi9gcNrn2a9cxU&_nc_zt=14&_nc_ht=scontent.fagc1-2.fna&_nc_gid=GQQvB9fvdDdRcBJTzMh3GA&_nc_ss=7b289&oh=00_AQMg2aHYaU7YUpCFHu66tYT0rKYi9Nzf0KbrCm3LMn672A&oe=6AD2D306",
      "page_likes": 39504574,
      "page_categories": [
        "Sportswear",
        "Product/service"
      ],
      "display_format": "dpa",
      "body": "Bring sports more fully into your day with the Nike App.",
      "caption": "itunes.apple.com",
      "link": "http://itunes.apple.com/app/id1095459556",
      "call_to_action": "Install now",
      "call_to_action_type": "INSTALL_MOBILE_APP",
      "cards": [
        {
          "title": "Nike F.C. Barcelona 2023/24 Stadium Fourth Women's Nike Dri-FIT Football Shirt",
          "body": "Bring sports more fully into your day with the Nike App.",
          "caption": "itunes.apple.com",
          "link": "https://www.nike.com/ph/t/fc-barcelona-2023-24-stadium-fourth-dri-fit-football-shirt-j09wGH/DR5081-729",
          "link_description": "₱3,595",
          "call_to_action": "Install Now",
          "call_to_action_type": "INSTALL_MOBILE_APP",
          "original_image": "https://scontent.xx.fbcdn.net/v/t39.35426-6/431734766_930233981755195_3984431312184472988_n.jpg?_nc_cat=104&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=BHTOHfVFB-UQ7kNvwEKw6fB&_nc_oc=AdrfU0tGmmGRaJ17N6C6lOPdJ3HvQQ9nx9cFWZxpWEodOA5l1agEcL1GNd-T1P8oIz0&_nc_zt=14&_nc_ht=scontent.fagc1-2.fna&_nc_gid=GQQvB9fvdDdRcBJTzMh3GA&_nc_ss=7b289&oh=00_AQO7m-iMfYfqxSRxUriGLLkZHD-vvcDyPKyTbWnfF6DWiw&oe=6AD2B42B",
          "resized_image": "https://scontent.xx.fbcdn.net/v/t39.35426-6/431734766_930233981755195_3984431312184472988_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=104&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=BHTOHfVFB-UQ7kNvwEKw6fB&_nc_oc=AdrfU0tGmmGRaJ17N6C6lOPdJ3HvQQ9nx9cFWZxpWEodOA5l1agEcL1GNd-T1P8oIz0&_nc_zt=14&_nc_ht=scontent.fagc1-2.fna&_nc_gid=GQQvB9fvdDdRcBJTzMh3GA&_nc_ss=7b289&oh=00_AQOWKsIvuzTM8DYdxHXk6mSCYjjSWSJb2ZzsLwiLO8Rraw&oe=6AD2B42B"
        },
        {
          "title": "Cosmic Unity 3 Basketball Shoes",
          "body": "Bring sports more fully into your day with the Nike App.",
          "caption": "itunes.apple.com",
          "link": "https://www.nike.com/ph/t/cosmic-unity-3-basketball-shoes-hcwmW0/DV2757-100",
          "link_description": "₱5,039",
          "call_to_action": "Install Now",
          "call_to_action_type": "INSTALL_MOBILE_APP",
          "original_image": "https://scontent.xx.fbcdn.net/v/t39.35426-6/431644642_737508601479774_8272309847273720820_n.jpg?_nc_cat=102&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=HGaaT2O6uIEQ7kNvwF_WFwr&_nc_oc=AdqrTI-MiHmuqucx8-w5GT1oXRyOcJ3d4WZzVakD23J7meVQxxoQiWMjkTDc_IcGByY&_nc_zt=14&_nc_ht=scontent.fagc1-1.fna&_nc_gid=GQQvB9fvdDdRcBJTzMh3GA&_nc_ss=7b289&oh=00_AQMxAhqfAJmEcDwRxbCiHcOoB7nQSIRaiHTNtRpCXLdIjw&oe=6AD2D103",
          "resized_image": "https://scontent.xx.fbcdn.net/v/t39.35426-6/431644642_737508601479774_8272309847273720820_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=102&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=HGaaT2O6uIEQ7kNvwF_WFwr&_nc_oc=AdqrTI-MiHmuqucx8-w5GT1oXRyOcJ3d4WZzVakD23J7meVQxxoQiWMjkTDc_IcGByY&_nc_zt=14&_nc_ht=scontent.fagc1-1.fna&_nc_gid=GQQvB9fvdDdRcBJTzMh3GA&_nc_ss=7b289&oh=00_AQPc1eE3nZ7kAlWuU1manl8_eYawM7VxDBIFzBcgksPS0Q&oe=6AD2D103"
        },
        ...
      ]
    },
    {
      "position": 2,
      "ad_archive_id": "1559738104701476",
      "details_link": "https://www.facebook.com/ads/library/?id=1559738104701476",
      "is_active": true,
      "start_date": "2025-04-25",
      "publisher_platforms": [
        "facebook",
        "instagram",
        "audience_network",
        "messenger"
      ],
      "page_id": "15087023444",
      "page_name": "Nike",
      "page_profile_link": "https://www.facebook.com/nike/",
      "page_profile_picture": "https://scontent.xx.fbcdn.net/v/t39.35426-6/400027547_358739853502630_8144226094621458298_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=107&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Qv0fic6IlE0Q7kNvwH6_rzD&_nc_oc=AdrAYOwstOrCmg-a-WXIIOmtPhlJxsQpk2D8oJbSYv7POX_NwicY2g4cJwG8WzErPRg&_nc_zt=14&_nc_ht=scontent.fagc1-1.fna&_nc_gid=GQQvB9fvdDdRcBJTzMh3GA&_nc_ss=7b289&oh=00_AQN4urUu-fp6dIdtBxqt1rB_lbtS-UkHi2rlVmOMGBiYRA&oe=6AD2C3B7",
      "page_likes": 39504574,
      "page_categories": [
        "Sportswear",
        "Product/service"
      ],
      "display_format": "dpa",
      "body": "Encuentra tu mejor estilo.\nLlegó el momento de que disfrutes los beneficios que la Nike App tiene para ti 😎. ¡Descárgala ahora!",
      "caption": "play.google.com",
      "link": "http://play.google.com/store/apps/details?id=com.nike.omega",
      "call_to_action": "Install now",
      "call_to_action_type": "INSTALL_MOBILE_APP",
      "cards": [
        {
          "title": "Camiseta de tirantes estampada cropped para mujer Nike Dri-FIT One - Negro",
          "body": "Encuentra tu mejor estilo.\nLlegó el momento de que disfrutes los beneficios que la Nike App tiene para ti 😎. ¡Descárgala ahora!",
          "caption": "play.google.com",
          "link": "https://www.nike.com/mx/t/camiseta-de-tirantes-estampada-cropped-dri-fit-one-Rbwdbp?cp=54413048966_soc_",
          "link_description": "$584",
          "call_to_action": "Install Now",
          "call_to_action_type": "INSTALL_MOBILE_APP",
          "original_image": "https://scontent.xx.fbcdn.net/v/t39.35426-6/399930460_249559881434186_1655395527070305162_n.jpg?_nc_cat=109&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Jhj3fPzg5ooQ7kNvwFf0Vu4&_nc_oc=Adoe4HhHKfdrJmhtgNi8YfuPKiGaF7QcZ-pkQwtQhyzx-7XNiAkSP5fs6Lv--YzuZ5s&_nc_zt=14&_nc_ht=scontent.fagc1-1.fna&_nc_gid=GQQvB9fvdDdRcBJTzMh3GA&_nc_ss=7b289&oh=00_AQNEZGtNE9ZutK_rVVf5stzpWeivrQgnwDJ62JGwiHTiNA&oe=6AD2D004",
          "resized_image": "https://scontent.xx.fbcdn.net/v/t39.35426-6/399930460_249559881434186_1655395527070305162_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=109&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Jhj3fPzg5ooQ7kNvwFf0Vu4&_nc_oc=Adoe4HhHKfdrJmhtgNi8YfuPKiGaF7QcZ-pkQwtQhyzx-7XNiAkSP5fs6Lv--YzuZ5s&_nc_zt=14&_nc_ht=scontent.fagc1-1.fna&_nc_gid=GQQvB9fvdDdRcBJTzMh3GA&_nc_ss=7b289&oh=00_AQPrh3pWypwXkJ8bUstus_eDhDJI_pFXU6OMNs_e5E6dwA&oe=6AD2D004"
        },
        {
          "title": "Nike Dri-FIT ADV A.P.S. Chamarra de condición física para hombre - Negro",
          "body": "Encuentra tu mejor estilo.\nLlegó el momento de que disfrutes los beneficios que la Nike App tiene para ti 😎. ¡Descárgala ahora!",
          "caption": "play.google.com",
          "link": "https://www.nike.com/mx/t/dri-fit-adv-aps-chamarra-de-condición-física-7MzcVt?cp=54413048966_soc_",
          "link_description": "$2,069",
          "call_to_action": "Install Now",
          "call_to_action_type": "INSTALL_MOBILE_APP",
          "original_image": "https://scontent.xx.fbcdn.net/v/t39.35426-6/399982152_693805559478496_8949402392943933768_n.jpg?_nc_cat=101&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=dX4V6QTIX9oQ7kNvwH89Ucr&_nc_oc=AdrkR2o4agNRNkqOStMp2RrPXagrzuwHvg2LgRInDDEKw-fIJgPA-ZwhxTio9XXLKnA&_nc_zt=14&_nc_ht=scontent.fagc1-2.fna&_nc_gid=GQQvB9fvdDdRcBJTzMh3GA&_nc_ss=7b289&oh=00_AQOX5dSwMR28iPzKbjEitGlfo-PbtfCL3GYcriItW6ZmsA&oe=6AD2CFE7",
          "resized_image": "https://scontent.xx.fbcdn.net/v/t39.35426-6/399982152_693805559478496_8949402392943933768_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=101&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=dX4V6QTIX9oQ7kNvwH89Ucr&_nc_oc=AdrkR2o4agNRNkqOStMp2RrPXagrzuwHvg2LgRInDDEKw-fIJgPA-ZwhxTio9XXLKnA&_nc_zt=14&_nc_ht=scontent.fagc1-2.fna&_nc_gid=GQQvB9fvdDdRcBJTzMh3GA&_nc_ss=7b289&oh=00_AQO5Me3x_niYUPKWfjMVgdyUAThX1Uo7xaoOuS6OkPhznA&oe=6AD2CFE7"
        },
        ...
      ]
    },
    ...
  ]
}

Result for  ad_type: political_and_issue_ads

ad_type gets the ads of a category. Ads about social issues, elections or politics have their spend in currency, their impressions, their estimated_audience_size, and who they were paid_for_by. With active_status set to all, the results include the ads that stopped running, with their end_date.

The Ad Library shows a notice instead of the content of some ads, like ads removed because they didn't follow Meta's Advertising Standards: their gated_type is why.

Result for  ad_type: political_and_issue_ads Result for  ad_type: political_and_issue_ads

JSON Example

{
  ...
  "ads": [
    {
      "position": 1,
      "ad_archive_id": "317161109571794",
      "details_link": "https://www.facebook.com/ads/library/?id=317161109571794",
      "is_active": false,
      "start_date": "2020-09-22",
      "end_date": "2020-10-05",
      "publisher_platforms": [
        "facebook"
      ],
      "categories": [
        "political"
      ],
      "collation_count": 2,
      "collation_id": "726473194573350",
      "page_id": "108824017345866",
      "page_name": "Meta",
      "page_profile_link": "https://www.facebook.com/Meta/",
      "page_profile_picture": "https://scontent-lga3-2.xx.fbcdn.net/v/t1.6435-9/119568341_200337161527884_7846459746434232698_n.png?stp=dst-png_s60x60&_nc_cat=100&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=9A9qPZEZpOMQ7kNvwEKsD2C&_nc_oc=AdouMipI3zjn8qQtVHY-Hs6ZJmpm0337C3gid1MsyvJSZsWhTrCBVFuRBTA_iTqnapo&_nc_zt=23&_nc_ht=scontent-lga3-2.xx&_nc_gid=q4eERuZZg-RZ8gG4uYp5LA&_nc_ss=7b289&oh=00_AQNSltIkD0XSveVjDgSTrdDXBKUSXsJ1ThLo8ywpIgdSAA&oe=6AF47D8E",
      "page_likes": 106693970,
      "page_categories": [
        "Internet Company"
      ],
      "display_format": "video",
      "title": "Voting Information Center",
      "body": "The Voting Information Center—one-tap voting registration information from election experts and authorities in one place.",
      "caption": "fb.com/votinginfocenter",
      "link": "http://facebook.com/votinginformationcenter",
      "link_description": "Get prepared for this election",
      "call_to_action": "Learn more",
      "call_to_action_type": "LEARN_MORE",
      "videos": [
        {
          "video_sd": "https://video-lga3-3.xx.fbcdn.net/o1/v/t2/f2/m412/AQNN757NtitUcJnpv0ODeMH6fXo-yFM-X90P2W82Zsrc70oOzST9lrKgscKf21SHBUtZ9pdKMclY8s32B0eRJ7o.mp4?_nc_cat=106&_nc_sid=ef5aa3&_nc_ht=video-lga3-3.xx.fbcdn.net&_nc_ohc=2up_uruHaYIQ7kNvwGBx5L-&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5WSV9VU0VDQVNFX1BST0RVQ1RfVFlQRS4uQzMuMzQwLmFzaWNfaHExX3NkX3Byb2dyZXNzaXZlIiwieHB2X2Fzc2V0X2lkIjo4MzE0MTAwMzMxNDk2MzYsImFzc2V0X2FnZV9kYXlzIjozMTgsInZpX3VzZWNhc2VfaWQiOjEwNjgwLCJkdXJhdGlvbl9zIjoxNSwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=q4eERuZZg-RZ8gG4uYp5LA&_nc_ss=7b289&_nc_zt=28&oh=00_AQOl57TIcv71Ou0GaSPQGmG12nlGirrhuEVw5xkuWkFy0g&oe=6AD2E688",
          "video_preview_image": "https://scontent-lga3-2.xx.fbcdn.net/v/t39.35426-6/120065387_2711663819108220_8472417301728012411_n.jpg?_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=sMWNT3g9Dy4Q7kNvwHpq-Vl&_nc_oc=AdqC3BuaaRlNPuFuFSOqs1MZ-BxdLYMT4d1p09qtsmzqL-Hh5uC8TOUb2QU-WSAw32Q&_nc_zt=14&_nc_ht=scontent-lga3-2.xx&_nc_gid=q4eERuZZg-RZ8gG4uYp5LA&_nc_ss=7b289&oh=00_AQOv3yEtzLb5BvRWkBoI8bx5kosQk56E_sy0up9G0zhCOA&oe=6AD2D04A"
        }
      ],
      "paid_for_by": "Facebook, Inc.",
      "spend": ">$1M",
      "currency": "USD",
      "impressions": ">1M",
      "estimated_audience_size": ">1M"
    },
    {
      "position": 3,
      "ad_archive_id": "352695862528588",
      "details_link": "https://www.facebook.com/ads/library/?id=352695862528588",
      "is_active": false,
      "gated_type": "taken_down",
      "start_date": "2020-08-27",
      "end_date": "2020-08-30",
      "publisher_platforms": [
        "facebook"
      ],
      "categories": [
        "political"
      ],
      "collation_count": 1,
      "collation_id": "228172181923561",
      "page_id": "20531316728",
      "page_name": "Facebook",
      "page_profile_link": "https://www.facebook.com/facebook/",
      "page_profile_picture": "https://scontent-lga3-3.xx.fbcdn.net/v/t39.35426-6/123254501_376431443560946_8642123156381274111_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=FP2TfoXRbv0Q7kNvwHQQMuh&_nc_oc=AdpSwEp-0rzragQhXJ5t-HTmAAB2JjOg2lH2DopzRxNLuMWtW7x7EibxwbbxRhhIx2o&_nc_zt=14&_nc_ht=scontent-lga3-3.xx&_nc_gid=q4eERuZZg-RZ8gG4uYp5LA&_nc_ss=7b289&oh=00_AQMjrLQgz9cgPIGt1VwPFlW3XwdgjehpQfW7QQ36Gcv5VQ&oe=6AD2C9B0",
      "page_likes": 154620269,
      "page_categories": [
        "Website",
        "Company"
      ],
      "display_format": "video",
      "title": "Change Together: From the March on Washington to Today",
      "body": "Queen Latifah hosts a series of candid conversations honoring the 57th anniversary of the #MarchOnWashington and this new era of the civil rights movement. Change Together features notable civil rights leaders such as Patrisse Cullors, Reverend Al Sharpton, and Kendrick Sampson, as well as social justice advocates Amanda Seales, Common and musical guest, CHIKA. Let’s come together to #LiftBlackVoices, learn and move as one toward equality and freedom.",
      "videos": [
        {
          "video_sd": "https://video-lga3-2.xx.fbcdn.net/o1/v/t2/f2/m412/AQOhKuKthAVVa0rFEi41ggsiGpIjueM36xj6WP_vqqtBOe-ys_sa5nUBYG9fKBArU14yCLHp-zR-F0aBPcYRtpg.mp4?_nc_cat=107&_nc_sid=ef5aa3&_nc_ht=video-lga3-2.xx.fbcdn.net&_nc_ohc=FvjPcqFjELIQ7kNvwHndg6-&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5WSV9VU0VDQVNFX1BST0RVQ1RfVFlQRS4uQzMuNDAwLmFzaWNfaHExX3NkX3Byb2dyZXNzaXZlIiwieHB2X2Fzc2V0X2lkIjoxMDUzMzI1NDAzNjA2NjM5LCJhc3NldF9hZ2VfZGF5cyI6NDY2LCJ2aV91c2VjYXNlX2lkIjoxMDY4MCwiZHVyYXRpb25fcyI6MzY5OSwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=q4eERuZZg-RZ8gG4uYp5LA&_nc_ss=7b289&_nc_zt=28&oh=00_AQP7aK1lSgMJCwVlilcSfIvFOJpquqiB_Iqtwzk_nRqFwA&oe=6AD2CFFF",
          "video_preview_image": "https://scontent-lga3-1.xx.fbcdn.net/v/t39.35426-6/123131854_3586232378268717_4745383357747290556_n.jpg?_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=73uiu3QnabEQ7kNvwG6nA1K&_nc_oc=AdrJeMUI_zx-U9N3AwIl8PlP5vTNZaX24SjMZIncnhJkHN17pDhpcAc97vRLUCDoZDY&_nc_zt=14&_nc_ht=scontent-lga3-1.xx&_nc_gid=q4eERuZZg-RZ8gG4uYp5LA&_nc_ss=7b289&oh=00_AQO8yMD1Evg3-lIsxZBz7bnpaP6NA4hsD6pg0Q40eyhnFQ&oe=6AD2BC30"
        }
      ],
      "paid_for_by": "Facebook, Inc.",
      "spend": ">$1M",
      "currency": "USD",
      "impressions": ">1M",
      "estimated_audience_size": ">1M"
    },
    ...
  ]
}

Result for  media_type: video and sort_by: impressions_high_to_low

media_type gets the ads with a type of media, and sort_by sorts the results, like the Ad Library's filters. Videos have links to their HD and SD versions, and to their preview image.

Result for  media_type: video and sort_by: impressions_high_to_low Result for  media_type: video and sort_by: impressions_high_to_low

JSON Example

{
  ...
  "ads": [
    {
      "position": 2,
      "ad_archive_id": "1235897841583167",
      "details_link": "https://www.facebook.com/ads/library/?id=1235897841583167",
      "is_active": true,
      "start_date": "2026-02-11",
      "publisher_platforms": [
        "instagram"
      ],
      "collation_count": 1,
      "collation_id": "896748173344148",
      "page_id": "119900441421720",
      "page_name": "Candlewood Suites",
      "page_profile_link": "https://www.facebook.com/CandlewoodSuites/",
      "page_profile_picture": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.35426-6/633714413_1963599347909585_2720747749030576490_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=GWLx6IGkrGsQ7kNvwE1YotR&_nc_oc=AdqEN7rFPuqt-afcX5rWCLJXxfNMoVtlxlB41psihUk7Hl2ZCa9MSkRn4frIj8wM_lV2PXvgTUqwzoZg-QFaxThy&_nc_zt=14&_nc_ht=scontent-iad3-1.xx&_nc_gid=pYA083xxjbWQWrUIMWRKew&_nc_ss=7b289&oh=00_AQODkyT5ya_l7Oni6x8_sn05jnToiwWl3-VAwJb-t0TFuQ&oe=6AD2D9E8",
      "page_likes": 114372,
      "page_categories": [
        "Travel Company"
      ],
      "display_format": "video",
      "body": "Rise, shine, and scramble. From fresh coffee to your morning favorites, our in-suite kitchens let you cook up comfort every day. \n\nWant more stays with your own kitchen? Download the IHG app at IHG.com/DownloadNow and start planning your next suite stay.",
      "caption": "www.instagram.com",
      "link": "https://www.instagram.com/candlewoodsuites/",
      "call_to_action": "Learn more",
      "call_to_action_type": "LEARN_MORE",
      "videos": [
        {
          "video_hd": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m86/AQM22PGNJQUC8fEiZCtPs-YPsHOLr9kv7LruycevBbjley7ObeoKEbhqs7A5L1zZhOmgxuv2hmkVsjXREvIyEc0Dv62DLiIhCjlYHVY.mp4?_nc_cat=108&_nc_sid=b66105&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=1m9zMt9VuNwQ7kNvwHm3Ygs&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5WSV9VU0VDQVNFX1BST0RVQ1RfVFlQRS4uQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTc4Njg0MTg5NDc1NDk0MDAsImFzc2V0X2FnZV9kYXlzIjoyNTUsInZpX3VzZWNhc2VfaWQiOjEyMzc0LCJkdXJhdGlvbl9zIjoxNCwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&vs=89b5785070103ded&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC81RjREOEQzQ0I1MzlERjQxNDk0NzE3OTBCMkVEMDE4NV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzk4NDkxODNFQzQ0QzYxOEQwNzg4MUQyNEIyREU0N0I3X2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACawo4jB7869PxUCKAJDMywXQC0zMzMzMzMYEmRhc2hfYmFzZWxpbmVfMV92MREAdQBlrMEBAA&_nc_gid=pYA083xxjbWQWrUIMWRKew&_nc_ss=7b289&_nc_zt=28&oh=00_AQOmHm8_JIENuGXgXZakNoqHpBSbwfQMOfQhY4SIqRDGCw&oe=6ACEE5BD",
          "video_sd": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m86/AQPjH_KiqK0sA2niL-4A6DYT9EzR3lPLzyxCRIOg4-ZelcX81XqVen6YPKhw5J3qZQO1BIvg5K9DDHiqCDKC-axXSSHN3LALIG47mK4.mp4?_nc_cat=103&_nc_sid=b66105&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=8u2t-a7ogU0Q7kNvwGYUb4I&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5WSV9VU0VDQVNFX1BST0RVQ1RfVFlQRS4uQzMuMzYwLmRhc2hfYmFzZWxpbmVfM192MSIsInhwdl9hc3NldF9pZCI6MTc4Njg0MTg5NDc1NDk0MDAsImFzc2V0X2FnZV9kYXlzIjoyNTUsInZpX3VzZWNhc2VfaWQiOjEyMzc0LCJkdXJhdGlvbl9zIjoxNCwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&vs=8eb0da4da37b5fa1&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC9FODRFODVCN0E3M0JCNjFBMkQxNDhFNzlBNTU2NzZBOF92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzk4NDkxODNFQzQ0QzYxOEQwNzg4MUQyNEIyREU0N0I3X2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACawo4jB7869PxUCKAJDMywXQC0zMzMzMzMYEmRhc2hfYmFzZWxpbmVfM192MREAdQBlrMEBAA&_nc_gid=pYA083xxjbWQWrUIMWRKew&_nc_ss=7b289&_nc_zt=28&oh=00_AQONJzYgIxrVdmayawqqdEQBLCjxD4iVHaKJpR3kYtN--g&oe=6ACEDC14",
          "video_preview_image": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.35426-6/631268980_1966646874240940_5364790766713531296_n.jpg?_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=w0ZX2T4TPaEQ7kNvwGvO0mf&_nc_oc=AdoCJsEvduKbTdB2jgvMHPPyGhRRtvTQ6hSJvNcOzeYTyBTF-zjYO0kdo4ipPV87h6KgsW11LP7-1rubNmC3cTRY&_nc_zt=14&_nc_ht=scontent-iad3-1.xx&_nc_gid=pYA083xxjbWQWrUIMWRKew&_nc_ss=7b289&oh=00_AQMwFakDdg6GyvilsdMgftUmRSRVFzGOf5wX08nVnszsmQ&oe=6AD2D51C"
        }
      ]
    },
    {
      "position": 6,
      "ad_archive_id": "27086586400970202",
      "details_link": "https://www.facebook.com/ads/library/?id=27086586400970202",
      "is_active": true,
      "start_date": "2026-06-13",
      "publisher_platforms": [
        "facebook",
        "instagram",
        "audience_network",
        "messenger",
        "threads"
      ],
      "eu_transparency": true,
      "collation_count": 1,
      "collation_id": "1306591561637611",
      "page_id": "114040321562599",
      "page_name": "Muse App",
      "page_profile_link": "https://www.facebook.com/100088641745631/",
      "page_profile_picture": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.35426-6/720736363_1018929863889850_5801135840208439969_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=C4L8NdZt7NYQ7kNvwGVdy6e&_nc_oc=AdpHDcAFkKjUMUzsHpWbSlZyAEffjsIumuldHDsjOcMfEjkK-UrYVXTXTY6McM4DaLy0FXekuXJiRMmc120Noebw&_nc_zt=14&_nc_ht=scontent-iad3-1.xx&_nc_gid=pYA083xxjbWQWrUIMWRKew&_nc_ss=7b289&oh=00_AQOzX6zj-PM1Fh68luDbgVgG1C4uujJ3ugPojv-b6K6oUQ&oe=6AD2E2F8",
      "page_likes": 909,
      "page_categories": [
        "Photo & Video"
      ],
      "display_format": "video",
      "title": "Muse: Best Reels Maker",
      "body": "Easy Reels  Maker! ✨ Try it now!",
      "caption": "itunes.apple.com",
      "link": "http://itunes.apple.com/app/id1638320348",
      "call_to_action": "Install now",
      "call_to_action_type": "INSTALL_MOBILE_APP",
      "videos": [
        {
          "video_hd": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m366/AQMVY5oW3uMBlSoihshn3IHc48DE3UU_LYZQw1ltgdXLwvVC0S6u59WGngaG2I756LJc4Fnw_94kkbmGV-9h3C6AyFQOl9FS7O4ru3GRVybApw.mp4?_nc_cat=110&_nc_sid=b66105&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=icZ4WSC4p-QQ7kNvwFA8pDw&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5WSV9VU0VDQVNFX1BST0RVQ1RfVFlQRS4uQzMuNzIwLmRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHAiLCJ4cHZfYXNzZXRfaWQiOjI0NTM5NzMwNDE3MzY0MTcsImFzc2V0X2FnZV9kYXlzIjoxMjYsInZpX3VzZWNhc2VfaWQiOjEwNzk5LCJkdXJhdGlvbl9zIjozMiwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&vs=978ce9754d04c95c&_nc_vs=HBksFQIYRWZiX2VwaGVtZXJhbC82RDRFNUVBRUY3NDEzN0RDRUU4NTIxMEIyMTdERkQ5Nl9tdF8xX3ZpZGVvX2Rhc2hpbml0Lm1wNBUAAsgBEgAVAhhAZmJfcGVybWFuZW50LzlGNDdCRDMzRTVEODFFMzUzMzFFNEQxMkRERTJGQkE1X2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbCq4f3g_jbCBUCKAJDMywXQEAAAAAAAAAYGWRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHARAHUAZd6oAQA&_nc_gid=pYA083xxjbWQWrUIMWRKew&_nc_ss=7b289&_nc_zt=28&oh=00_AQNILaRaQA-FkIjMKtX2rBCoBdiCNv0Wo5Lrwh7eYKrB1Q&oe=6AD2D6CA",
          "video_sd": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQO2-5UGzcS4ov0bs5fDjJ5NaSo_lt05qcltFtPbHBRKoyt95ypy5sgQNLHuH2fHzMiKAr5HyN8bBIejKLuLyf9y9c94s_VXdelNP7dbww.mp4?_nc_cat=108&_nc_sid=ef5aa3&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=JEb0zMAOq5gQ7kNvwENdx-S&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5WSV9VU0VDQVNFX1BST0RVQ1RfVFlQRS4uQzMuMzYwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6MjQ1Mzk3MzA0MTczNjQxNywiYXNzZXRfYWdlX2RheXMiOjEyNiwidmlfdXNlY2FzZV9pZCI6MTA3OTksImR1cmF0aW9uX3MiOjMyLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=pYA083xxjbWQWrUIMWRKew&_nc_ss=7b289&_nc_zt=28&oh=00_AQPM80n71ZIgAceDNc0D7W66aTeaqk4MIyFJXxT3m2MsxQ&oe=6AD2CF1A",
          "video_preview_image": "https://scontent-iad6-1.xx.fbcdn.net/v/t39.35426-6/724312690_1069521832341801_7587173568286400731_n.jpg?_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=ltj5XbU7bz0Q7kNvwFwz-5z&_nc_oc=AdofJlw-g5ThfHfxleeKdR3knL7DJV6D1AIm13XRWygwQy1uPu9NgTmBt8psGupQDdgMj8C5ubuVJGLVIWXTcpbs&_nc_zt=14&_nc_ht=scontent-iad6-1.xx&_nc_gid=pYA083xxjbWQWrUIMWRKew&_nc_ss=7b289&oh=00_AQPvvyD9BOahOovM6nK9fhtlQsr8gF6yNRe7p9vYH9D45g&oe=6AD2C7FE"
        }
      ]
    },
    ...
  ]
}

Result for  start_date, end_date, publisher_platforms, and content_languages

start_date and end_date get the ads shown during a date range, whenever they started running, like the Ad Library's impressions by date filter. publisher_platforms and content_languages get the ads shown on some platforms and in some languages.

Result for  start_date, end_date, publisher_platforms, and content_languages

JSON Example

{
  ...
  "ads": [
    {
      "position": 1,
      "ad_archive_id": "1456513328852406",
      "details_link": "https://www.facebook.com/ads/library/?id=1456513328852406",
      "is_active": true,
      "start_date": "2025-06-10",
      "publisher_platforms": [
        "facebook",
        "instagram",
        "audience_network",
        "messenger"
      ],
      "collation_count": 1,
      "collation_id": "544795848567374",
      "page_id": "209562942744",
      "page_name": "Domino's Pizza India",
      "page_profile_link": "https://www.facebook.com/dominospizzaindia/",
      "page_profile_picture": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/433897951_452939720637871_4686261082644896648_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=9YhANmuRizQQ7kNvwGIkph7&_nc_oc=Ado122YuVcmL6TmRqvFuvqpUqxXDRWFSgs9RdtP0oCtI2XvqYr8OO3kO1_nu6PIZbGE&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=aEu-7ggqYmpxE2407krgUQ&_nc_ss=7b289&oh=00_AQO9LYEcbdAKsO8mMjcQj-5tMIygK0VLWZesGgQDTaDutA&oe=6AD2CF0A",
      "page_likes": 6442355,
      "page_categories": [
        "Food & beverage company"
      ],
      "display_format": "dco",
      "caption": "play.google.com",
      "link": "http://play.google.com/store/apps/details?id=com.Dominos",
      "call_to_action": "Order now",
      "call_to_action_type": "ORDER_NOW",
      "cards": [
        {
          "title": "Use Code:- BUY2GET1",
          "body": "Craving Pizza? How about multiplying that craving by three? Domino's is offering FREE Delivery so indulge in the ultimate pizza feast with Domino's exclusive offer: Buy 2 Pizzas, Get 1 FREE! 🍕🍕🍕 Use Code BUY2GET1.",
          "link": "http://play.google.com/store/apps/details?id=com.Dominos",
          "call_to_action": "Order Now",
          "call_to_action_type": "ORDER_NOW",
          "original_image": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/431536738_1111137313422345_3243808617154474446_n.jpg?_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=jyy2r4T3sFgQ7kNvwGFyjff&_nc_oc=AdrjeEgwZqLK_5XZ6rQyaEvllFdamJCTfnD8jP6EnaKfiMrLvmy4Wfv2oWItNbSKRD8&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=aEu-7ggqYmpxE2407krgUQ&_nc_ss=7b289&oh=00_AQNV6aoRQUNrlrgLNoA_XE3SpsqsVwkwg4ydCZ1X-QeNcQ&oe=6AD2E44C",
          "resized_image": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/431499560_1131022294919577_6138805471811454314_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=101&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=rzDHICmg3dcQ7kNvwGMKMiV&_nc_oc=AdrPhX_Aqs2zCnQ7x7pYVleJ3Q4_8C6l1MT50w7e90redERvBaqzXtCbn58Ntw49WVw&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=aEu-7ggqYmpxE2407krgUQ&_nc_ss=7b289&oh=00_AQO73eRYUdCcE-L9VsNlS6UAt9-TomadFyrxQZwv8xydhw&oe=6AD2D94B"
        },
        {
          "title": "Use Code:- BUY2GET1",
          "body": "Craving Pizza? How about multiplying that craving by three? Domino's is offering FREE Delivery so indulge in the ultimate pizza feast with Domino's exclusive offer: Buy 2 Pizzas, Get 1 FREE! 🍕🍕🍕 Use Code BUY2GET1.",
          "link": "http://play.google.com/store/apps/details?id=com.Dominos",
          "call_to_action": "Order Now",
          "call_to_action_type": "ORDER_NOW",
          "original_image": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/431539605_425389979972804_741425408365137915_n.jpg?_nc_cat=102&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=7_bzH9dZtZcQ7kNvwGh7wqI&_nc_oc=AdpRZP07zscVoDx9A8g6AxA5EEI1ZgUK_zHRxQbE_ZHZli5Ba8HIYAgayPg-dKPX2GU&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=aEu-7ggqYmpxE2407krgUQ&_nc_ss=7b289&oh=00_AQNImP6KH8mJxn2owjGKs8JFy6JqKhI8GT4nwSaPLcQdhA&oe=6AD2D692",
          "resized_image": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/433860191_419580577281068_2105410514893384985_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=egeTNDoazucQ7kNvwHUHWWP&_nc_oc=Ado8hdCQN5FFHMb7KYifcSENUYIE7jOKQ2FBNJ7F9bVkSrqdbxuLm-7rPYW9rNMUz3Y&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=aEu-7ggqYmpxE2407krgUQ&_nc_ss=7b289&oh=00_AQN1ECVC3ZnxKhvJ2vYY8oKUU6ZF8zmMzNtcvZbntMG90A&oe=6AD2B985"
        }
      ]
    },
    {
      "position": 2,
      "ad_archive_id": "2272054406587344",
      "details_link": "https://www.facebook.com/ads/library/?id=2272054406587344",
      "is_active": true,
      "start_date": "2025-06-21",
      "publisher_platforms": [
        "facebook",
        "instagram",
        "audience_network",
        "messenger"
      ],
      "collation_count": 1,
      "collation_id": "589877190064899",
      "page_id": "209562942744",
      "page_name": "Domino's Pizza India",
      "page_profile_link": "https://www.facebook.com/dominospizzaindia/",
      "page_profile_picture": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/493977661_648836141449420_915352303289071790_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=xUYRv03oyMYQ7kNvwFhHDvP&_nc_oc=AdpolRrN39iSj0vmyg3UADq4SrsijMEzz_Ncra_SJJXHca-L20qjBhV0aG9oDWVI8Fg&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=aEu-7ggqYmpxE2407krgUQ&_nc_ss=7b289&oh=00_AQNOo8NqIfzJvLl6lMP5lZvb3JdFHb9wq4kTrTF67j17eA&oe=6AD2CA8B",
      "page_likes": 6442355,
      "page_categories": [
        "Food & beverage company"
      ],
      "display_format": "dco",
      "caption": "itunes.apple.com",
      "link": "http://itunes.apple.com/app/id523106486",
      "call_to_action": "Order now",
      "call_to_action_type": "ORDER_NOW",
      "cards": [
        {
          "title": "Use Code:- BUY2GET1",
          "body": "𝐅𝐫𝐞𝐞 𝐃𝐞𝐥𝐢𝐯𝐞𝐫𝐲 | 𝐁𝐞𝐬𝐭 𝐏𝐫𝐢𝐜𝐞 | 𝐙𝐞𝐫𝐨 𝐒𝐮𝐫𝐠𝐞\nCraving Pizza? How about multiplying that craving by three? Domino's is offering FREE Delivery so indulge in the ultimate pizza feast with Domino's exclusive offer: Buy 2 Pizzas, Get 1 FREE! 🍕🍕🍕 Unlimited flavor!",
          "link": "http://itunes.apple.com/app/id523106486",
          "call_to_action": "Order Now",
          "call_to_action_type": "ORDER_NOW",
          "original_image": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/494147337_701707238863001_1682168988756440035_n.jpg?_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=cIzbUSYq-TcQ7kNvwHBGJB_&_nc_oc=AdrOiOC-H6QOYHYE4SMHTM4o5nVSZITiU_PbpyUBwK_H8H1DiK_zyOeVvFFRpYUWosw&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=aEu-7ggqYmpxE2407krgUQ&_nc_ss=7b289&oh=00_AQMNYgsfFcBarWi9p839d9n4cLMxFdu3UVmbbRe0jBOUWQ&oe=6AD2D65E",
          "resized_image": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/494183796_678990625078812_8017336224713987829_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=3aU844FEfnIQ7kNvwGBpuDT&_nc_oc=AdopuX-N0m-6wuWk0NKf30NjhEzezgG7g2ZFspziyZDQAr2Hwi-cspQO0esrXRmvwVU&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=aEu-7ggqYmpxE2407krgUQ&_nc_ss=7b289&oh=00_AQMnC0hAaNnTqAfmoIJiZ9ihACm3fH9t2xKmcuVeesHubg&oe=6AD2C85F"
        },
        {
          "title": "Use Code:- BUY2GET1",
          "body": "𝐅𝐫𝐞𝐞 𝐃𝐞𝐥𝐢𝐯𝐞𝐫𝐲 | 𝐁𝐞𝐬𝐭 𝐏𝐫𝐢𝐜𝐞 | 𝐙𝐞𝐫𝐨 𝐒𝐮𝐫𝐠𝐞\nCraving Pizza? How about multiplying that craving by three? Domino's is offering FREE Delivery so indulge in the ultimate pizza feast with Domino's exclusive offer: Buy 2 Pizzas, Get 1 FREE! 🍕🍕🍕 Unlimited flavor!",
          "link": "http://itunes.apple.com/app/id523106486",
          "call_to_action": "Order Now",
          "call_to_action_type": "ORDER_NOW",
          "original_image": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/494032690_1744474426427313_1818368146856505175_n.jpg?_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=NbruQVhSFhcQ7kNvwFJed_5&_nc_oc=AdrY0Gt7BMVH-OpapB-KRDaQYXfX4nSxAIYtcEEO3vo2-4kC8O6EiS4VGr57C7Ecwrs&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=aEu-7ggqYmpxE2407krgUQ&_nc_ss=7b289&oh=00_AQOx0hz_4bScUHBWV2lGHEQUbdb0i7yiSunZxJ3B_RPuNg&oe=6AD2BCC7",
          "resized_image": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/492601432_1182584676418373_6680082654016191562_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=102&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=ZJWGA1s_AwYQ7kNvwFNBURN&_nc_oc=AdqVXSEz3d9jsgWLfKcZLpPWJ2YFTfjE46GJLMeiQ-jpvkD6hhmnsxKD__D68va8wQo&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=aEu-7ggqYmpxE2407krgUQ&_nc_ss=7b289&oh=00_AQOULfGTOdCg3fU17rGvxwpXCI2SS1Ayy-lSymUjUWZ75w&oe=6AD2D578"
        }
      ]
    },
    ...
  ]
}

Result for  next_page_token

The Ad Library loads more ads as its page is scrolled. serpapi_pagination.next is the SerpApi link to the next ads, with the serpapi_pagination.next_page_token of the page set as next_page_token. Each page has up to 30 ads. Only the first page has search_information.total_results, and the advertiser of page_id.


JSON Example

{
  ...
  "ads": [
    {
      "position": 1,
      "ad_archive_id": "1737537040906264",
      "details_link": "https://www.facebook.com/ads/library/?id=1737537040906264",
      "is_active": true,
      "start_date": "2026-07-29",
      "publisher_platforms": [
        "facebook",
        "instagram",
        "audience_network",
        "messenger"
      ],
      "page_id": "15087023444",
      "page_name": "Nike",
      "page_profile_link": "https://www.facebook.com/nike/",
      "page_profile_picture": "https://scontent-det1-1.xx.fbcdn.net/v/t39.35426-6/759622422_903833082224835_141985525016994253_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=uXpMox2GlbQQ7kNvwEoL7Ns&_nc_oc=AdqmREIRgggrphWgkDU98Tz7Yph2JE7LoLOYMHzkkoVM1EudMAM1uj-PId70r-P4E4I&_nc_zt=14&_nc_ht=scontent-det1-1.xx&_nc_gid=IrvvwAqBfuDwTu8nuBBauA&_nc_ss=7b289&oh=00_AQOFNJCfSw-WxRSJX6GNTyFw6TUW7QW2ngWFoPPp4zHPjQ&oe=6AD2CF7D",
      "page_likes": 39504577,
      "page_categories": [
        "Sportswear"
      ],
      "display_format": "dpa",
      "title": "Nike",
      "body": "Compra desde la Nike App y encuentra novedades de sneakers con la última tecnología y la máxima innovación.",
      "caption": "nike.com",
      "link": "http://www.nike.com/",
      "call_to_action": "Install now",
      "call_to_action_type": "INSTALL_MOBILE_APP",
      "cards": [
        {
          "title": "Nike",
          "body": "Compra desde la Nike App y encuentra novedades de sneakers con la última tecnología y la máxima innovación.",
          "caption": "nike.com",
          "link": "https://www.nike.com/mx/t/googles-swim-hyper-flow-b7Sal3kH/FD3455-006?cp=54413048966_soc_",
          "link_description": "Nike delivers innovative products, experiences and services to inspire athletes.",
          "call_to_action": "Install Now",
          "call_to_action_type": "INSTALL_MOBILE_APP",
          "original_image": "https://scontent-det1-1.xx.fbcdn.net/v/t39.35426-6/759796493_2224196081702659_9032076094556573303_n.jpg?_nc_cat=102&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=oipelFEVjF4Q7kNvwEXTurL&_nc_oc=Adrdrzkd10aSlq7Ejjtybcp9QT9ETEpKgxx5gOZLSkm4aMeCTGn2xLyoiYpZYa7_AS0&_nc_zt=14&_nc_ht=scontent-det1-1.xx&_nc_gid=IrvvwAqBfuDwTu8nuBBauA&_nc_ss=7b289&oh=00_AQO311OpV2SjKFbdSh130BRPHFtuL67hVlyf-gLyeYR1ow&oe=6AD2D002",
          "resized_image": "https://scontent-det1-1.xx.fbcdn.net/v/t39.35426-6/759796493_2224196081702659_9032076094556573303_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=102&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=oipelFEVjF4Q7kNvwEXTurL&_nc_oc=Adrdrzkd10aSlq7Ejjtybcp9QT9ETEpKgxx5gOZLSkm4aMeCTGn2xLyoiYpZYa7_AS0&_nc_zt=14&_nc_ht=scontent-det1-1.xx&_nc_gid=IrvvwAqBfuDwTu8nuBBauA&_nc_ss=7b289&oh=00_AQMfOLzBsZb1pau7k_DrFqzJlDKa-73mpEW58AlIwfRoXg&oe=6AD2D002"
        },
        {
          "title": "Nike",
          "body": "Compra desde la Nike App y encuentra novedades de sneakers con la última tecnología y la máxima innovación.",
          "caption": "nike.com",
          "link": "https://www.nike.com/mx/t/calcetines-de-futbol-hasta-la-rodilla-nike-academy-wwdjrW/SX4120-101?cp=54413048966_soc_",
          "link_description": "Nike delivers innovative products, experiences and services to inspire athletes.",
          "call_to_action": "Install Now",
          "call_to_action_type": "INSTALL_MOBILE_APP",
          "original_image": "https://scontent-det1-1.xx.fbcdn.net/v/t39.35426-6/757799958_1268286255274490_9178120499504603857_n.jpg?_nc_cat=100&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Y61sgYg5z94Q7kNvwHVkdu_&_nc_oc=AdpmOcYr8szpt3HqvIb1nCwy8LMNjcshdj2yVXWflvIxzZoCOw3kS6xEwEXhr_BHu2o&_nc_zt=14&_nc_ht=scontent-det1-1.xx&_nc_gid=IrvvwAqBfuDwTu8nuBBauA&_nc_ss=7b289&oh=00_AQMT_khdbySJrsIUe-bSEjPMwjUaHhwlPzUA8gUn8rMK5g&oe=6AD2DB3B",
          "resized_image": "https://scontent-det1-1.xx.fbcdn.net/v/t39.35426-6/757799958_1268286255274490_9178120499504603857_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=100&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Y61sgYg5z94Q7kNvwHVkdu_&_nc_oc=AdpmOcYr8szpt3HqvIb1nCwy8LMNjcshdj2yVXWflvIxzZoCOw3kS6xEwEXhr_BHu2o&_nc_zt=14&_nc_ht=scontent-det1-1.xx&_nc_gid=IrvvwAqBfuDwTu8nuBBauA&_nc_ss=7b289&oh=00_AQOiDN9zqHJQtUPIcy6tAT_JMuefvvOvHkv1ULDVWq1ErA&oe=6AD2DB3B"
        },
        ...
      ]
    },
    {
      "position": 2,
      "ad_archive_id": "781223554567620",
      "details_link": "https://www.facebook.com/ads/library/?id=781223554567620",
      "is_active": true,
      "start_date": "2026-02-27",
      "publisher_platforms": [
        "facebook",
        "instagram",
        "audience_network",
        "messenger"
      ],
      "page_id": "117477791613088",
      "page_name": "sportscene",
      "page_profile_link": "https://www.facebook.com/sportscene.southafrica/",
      "page_profile_picture": "https://scontent-det1-1.xx.fbcdn.net/v/t39.35426-6/503410625_1487376145565143_6110991827394813104_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=102&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=OifDdWE2RzsQ7kNvwFy8uQ4&_nc_oc=Adpm03ff3tD-jI7HBEpMZU59NMqvAPiLS8INveIM9eDF2cL0NPBVzh4oakLdFM4it8E&_nc_zt=14&_nc_ht=scontent-det1-1.xx&_nc_gid=IrvvwAqBfuDwTu8nuBBauA&_nc_ss=7b289&oh=00_AQNJrpqLN8ip_71FioqPniLhZbu1CcMyqpaoQY2-1hizzw&oe=6AD2E3F2",
      "page_likes": 3164096,
      "page_categories": [
        "Clothing (Brand)"
      ],
      "display_format": "dpa",
      "body": "Shop your Nike favourites from sportscene online. Free delivery on orders over R650.",
      "caption": "bash.com",
      "link": "https://bash.com/sportscene/brands/nike",
      "call_to_action": "Shop now",
      "call_to_action_type": "SHOP_NOW",
      "cards": [
        {
          "title": "Nike Men's Air Force 1 Mid '07 Black Sneaker",
          "body": "Shop your Nike favourites from sportscene online. Free delivery on orders over R650.",
          "caption": "bash.com",
          "link": "https://bash.com/nike-men-s-air-force-1-mid-07-black-sneaker-060601abug1/p",
          "link_description": "ZAR2,599.95",
          "call_to_action": "Shop Now",
          "call_to_action_type": "SHOP_NOW",
          "original_image": "https://scontent-det1-1.xx.fbcdn.net/v/t39.35426-6/503223959_685564907612607_6716752320236182819_n.jpg?_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=fplYtnIjgUwQ7kNvwH38a91&_nc_oc=AdpcymcVc6WnWVs5NezXW5IExd9iP5QR6J9XOyleyv78nWGiq2bDynmURy1CPARTw2I&_nc_zt=14&_nc_ht=scontent-det1-1.xx&_nc_gid=IrvvwAqBfuDwTu8nuBBauA&_nc_ss=7b289&oh=00_AQM2B-X3Xk0eechUH1flKJry4rJJYlqmcWcCL47Lm8yP6Q&oe=6AD2B899",
          "resized_image": "https://scontent-det1-1.xx.fbcdn.net/v/t39.35426-6/503223959_685564907612607_6716752320236182819_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=fplYtnIjgUwQ7kNvwH38a91&_nc_oc=AdpcymcVc6WnWVs5NezXW5IExd9iP5QR6J9XOyleyv78nWGiq2bDynmURy1CPARTw2I&_nc_zt=14&_nc_ht=scontent-det1-1.xx&_nc_gid=IrvvwAqBfuDwTu8nuBBauA&_nc_ss=7b289&oh=00_AQM1BHBo72JSTQ-jCc1qD5Us0zuuarXodOJp4urIB-cZ4g&oe=6AD2B899"
        },
        {
          "title": "Nike Men's Air Max 90 White Sneaker",
          "body": "Shop your Nike favourites from sportscene online. Free delivery on orders over R650.",
          "caption": "bash.com",
          "link": "https://bash.com/nike-men-s-air-max-90-white-sneaker-060601aeln7/p",
          "link_description": "ZAR2,999.95",
          "call_to_action": "Shop Now",
          "call_to_action_type": "SHOP_NOW",
          "original_image": "https://scontent-det1-1.xx.fbcdn.net/v/t39.35426-6/502943657_738880195160134_6891899293135724683_n.jpg?_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=kFNdijHzslkQ7kNvwFp9mtr&_nc_oc=Adpl3sjjd9NUvvqvkReNLFcoYhGki0T5wnMMKML5VIuG5UzTiZe7efgiRqYPUXmMGZ8&_nc_zt=14&_nc_ht=scontent-det1-1.xx&_nc_gid=IrvvwAqBfuDwTu8nuBBauA&_nc_ss=7b289&oh=00_AQMtycEN0wUwwuns14l7GQ0phAFfrLyR-emDHlFznwpjyQ&oe=6AD2D375",
          "resized_image": "https://scontent-det1-1.xx.fbcdn.net/v/t39.35426-6/502943657_738880195160134_6891899293135724683_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=kFNdijHzslkQ7kNvwFp9mtr&_nc_oc=Adpl3sjjd9NUvvqvkReNLFcoYhGki0T5wnMMKML5VIuG5UzTiZe7efgiRqYPUXmMGZ8&_nc_zt=14&_nc_ht=scontent-det1-1.xx&_nc_gid=IrvvwAqBfuDwTu8nuBBauA&_nc_ss=7b289&oh=00_AQNtWQFkKSufAFFENrB5mjs-KQQWF60xUylah3IurhvQaA&oe=6AD2D375"
        },
        ...
      ]
    },
    ...
  ],
  "serpapi_pagination": {
    "next_page_token": "AQHTT076278PAdupDQB1MaDusIliv-o9Amh1Ml3GQGUDMH1xFYojtM0QoE7XW3hh_GT6",
    "next": "https://serpapi.com/search.json?country=ALL&engine=meta_ad_library&next_page_token=AQHTT076278PAdupDQB1MaDusIliv-o9Amh1Ml3GQGUDMH1xFYojtM0QoE7XW3hh_GT6&q=nike"
  }
}

JSON Structure Overview

{
  ...
  "advertiser": {
    "page_id": "String - ID of the Facebook page of the advertiser of page_id.",
    "name": "String - Name of the advertiser.",
    "link": "String - Link to the Facebook page of the advertiser.",
    "profile_picture": "String - Link to the profile picture of the advertiser."
  },
  "ads": [
    {
      "position": "Integer - Position of the ad in the results of the page.",
      "ad_archive_id": "String - Library ID of the ad.",
      "details_link": "String - Link to the ad on the Ad Library.",
      "is_active": "Boolean - True if the ad is still running.",
      "gated_type": "String - Why the Ad Library shows a notice instead of the content of the ad: taken_down for ads removed because they didn't follow Meta's Advertising Standards, taken_down_legal for ads removed because they didn't follow local laws, ad_account_disabled for ads of an account or Page that Meta later disabled, disclaimer_review for ads removed because their disclaimer didn't follow Meta's policy for ads about social issues, elections or politics, missing_disclaimer for ads that ran without a required disclaimer, or logged_out for ads only shown to logged-in users who confirm their age.",
      "start_date": "String - Date the ad started running, in YYYY-MM-DD format.",
      "end_date": "String - Date the ad stopped running, in YYYY-MM-DD format. Only for inactive ads.",
      "publisher_platforms": [
        "String - Platform the ad was shown on. (Ex. facebook, instagram, audience_network, messenger, whatsapp, threads)"
      ],
      "categories": [
        "String - Category of the ad, like for ads about social issues, elections or politics. (Ex. political, housing, employment, credit for financial products and services)"
      ],
      "eu_transparency": "Boolean - True if the ad has the Ad Library's EU transparency, the additional information Meta provides for ads shown on its technologies anywhere in the EU. Most ads about social issues, elections or politics have their spend and impressions instead.",
      "collation_count": "Integer - Number of ads that use the creative and text of the ad.",
      "collation_id": "String - ID of the ads that use the creative and text of the ad.",
      "page_id": "String - ID of the Facebook page the ad appears from.",
      "page_name": "String - Name of the page.",
      "page_profile_link": "String - Link to the profile of the page. Pages without a username are linked with the ID of their profile, which isn't their page_id.",
      "page_profile_picture": "String - Link to the profile picture of the page.",
      "page_likes": "Integer - Number of likes of the page.",
      "page_categories": [
        "String - Category of the page. (Ex. Sportswear)"
      ],
      "display_format": "String - Format of the ad. (Ex. image, video, carousel, dco for ads with versions, dpa for ads of a product catalog)",
      "title": "String - Title of the link of the ad.",
      "body": "String - Text of the ad.",
      "caption": "String - Caption of the link of the ad, usually its domain.",
      "link": "String - Link the ad leads to.",
      "link_description": "String - Description of the link of the ad.",
      "call_to_action": "String - Text of the call to action button. (Ex. Shop now)",
      "call_to_action_type": "String - Type of the call to action. (Ex. SHOP_NOW, LEARN_MORE, INSTALL_MOBILE_APP)",
      "images": [
        {
          "original_image": "String - Link to the image.",
          "resized_image": "String - Link to the image, resized to 600 pixels."
        }
      ],
      "videos": [
        {
          "video_hd": "String - Link to the HD video.",
          "video_sd": "String - Link to the SD video.",
          "video_preview_image": "String - Link to the preview image of the video."
        }
      ],
      "cards": [
        {
          "title": "String - Title of the card: of a card of a carousel, or of a version of the ad.",
          "body": "String - Text of the card.",
          "caption": "String - Caption of the link of the card.",
          "link": "String - Link the card leads to.",
          "link_description": "String - Description of the link of the card, like the price of a product.",
          "call_to_action": "String - Text of the call to action button of the card.",
          "call_to_action_type": "String - Type of the call to action of the card.",
          "original_image": "String - Link to the image of the card.",
          "resized_image": "String - Link to the image of the card, resized to 600 pixels.",
          "video_hd": "String - Link to the HD video of the card.",
          "video_sd": "String - Link to the SD video of the card.",
          "video_preview_image": "String - Link to the preview image of the video of the card."
        }
      ],
      "extra_texts": [
        "String - Additional text of the ad, like a question of its form."
      ],
      "extra_links": [
        "String - Additional link of the ad."
      ],
      "extra_images": [
        {
          "original_image": "String - Link to an additional image of the ad.",
          "resized_image": "String - Link to the additional image, resized to 600 pixels."
        }
      ],
      "paid_for_by": "String - Who paid for the ad, for ads about social issues, elections or politics.",
      "spend": "String - Range of the amount spent on the ad. (Ex. $300 - $399)",
      "currency": "String - Currency of the amount spent on the ad. (Ex. USD)",
      "impressions": "String - Range of the number of times the ad was shown. (Ex. >1M)",
      "estimated_audience_size": "String - Range of the estimated number of people the ad could reach. (Ex. 100K - 500K)",
      "branded_content": {
        "page_id": "String - ID of the Facebook page of the brand the ad is a paid partnership with.",
        "page_name": "String - Name of the brand.",
        "page_profile_link": "String - Link to the profile of the Facebook page of the brand."
      }
    }
  ],
  "serpapi_pagination": {
    "next_page_token": "String - Token to get the next page, with next_page_token.",
    "next": "String - SerpApi link to the next page."
  }
}