zapi.
APIsPricingDocsMCP
APIsPricingDocsMCPSign in
zapi.
APIsPricingDocsMCP
APIsPricingDocsMCPSign in
On this page
  • Playground
  • Code examples
  • Full reference
  • Related APIs
Ads/Meta Ad Library
Logo Meta Ad Library

Meta Ad Library

Competitor ads running on Facebook, Instagram, Messenger and Threads — creative, copy, carousel cards and direct media, from Meta's public Ad Library.

Endpoints
3
Requests
85
Updated
6 hours ago
For LLMs
llms.txt
Endpoint healthnot yet measured
  • searchnot measured
  • advertiser-adsnot measured
  • ad-detailnot measured
no measurements yetdaily 01:00 WIB

Playground

3 endpoints
GET/v1/ads:meta/search10m cache6 paramschecking key…
Parameters
querystringrequired

Keyword to search ad copy and advertiser names for

countrystring

ISO 3166-1 alpha-2 country the ads were delivered in. Default ID

matchTypeenum

Keyword matching. exact requires the phrase verbatim. Default unordered

activeStatusenum

Delivery status of the ads. Default active

mediaTypeenum

Creative format filter. Default all

adTypeenum

Ad category. Default all

·
Response
EXAMPLE
{
  "ads": [
    {
      "adId": "978481707850213",
      "body": "Riapri TikTok oggi",
      "cards": [
        {
          "body": "Riapri TikTok oggi",
          "image": "https://scontent-cgk2-2.xx.fbcdn.net/v/t39.35426-6/592955169_835898305822436_5225486659854474314_n.jpg?_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=MpNFFt8dEU0Q7kNvwGd1LRI&_nc_oc=Ado…",
          "title": "Il tuo feed si è rinfrescato con contenuti che ti piacciono",
          "caption": "tiktok.com",
          "ctaText": "Learn More",
          "ctaType": "LEARN_MORE",
          "linkUrl": "https://www.tiktok.com/",
          "imageResized": "https://scontent-cgk2-2.xx.fbcdn.net/v/t39.35426-6/592955169_835898305822436_5225486659854474314_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=MpNFFt8dE…",
          "linkDescription": "TikTok - trends start here. On a device or on the web, viewers can watch and discover millions of personalized short videos. Download the app to get started."
        },
        {
          "body": "Riapri TikTok oggi",
          "image": "https://scontent-cgk1-2.xx.fbcdn.net/v/t39.35426-6/592570064_25465287146437403_807408166371539269_n.jpg?_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=N4Ztfy4avY4Q7kNvwEJuoAx&_nc_oc=Ad…",
          "title": "Il tuo feed si è rinfrescato con contenuti che ti piacciono",
          "caption": "tiktok.com",
          "ctaText": "Learn More",
          "ctaType": "LEARN_MORE",
          "linkUrl": "https://www.tiktok.com/",
          "imageResized": "https://scontent-cgk1-2.xx.fbcdn.net/v/t39.35426-6/592570064_25465287146437403_807408166371539269_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=N4Ztfy4a…",
          "linkDescription": "TikTok - trends start here. On a device or on the web, viewers can watch and discover millions of personalized short videos. Download the app to get started."
        }
      ],
      "title": "Il tuo feed si è rinfrescato con contenuti che ti piacciono",
      "pageId": "101039196037152",
      "caption": "tiktok.com",
      "ctaText": "Learn more",
      "ctaType": "LEARN_MORE",
      "endDate": 1788332400,
      "linkUrl": "http://www.tiktok.com/",
      "isActive": true,
      "pageName": "TikTok - EU",
      "gatedType": "ELIGIBLE",
      "startDate": 1776841200,
      "categories": [
        "UNKNOWN"
      ],
      "isReshared": false,
      "reportCount": 0,
      "displayFormat": "DPA",
      "isAaaEligible": true,
      "pageIsDeleted": false,
      "pageLikeCount": 45901,
      "collationCount": 0,
      "hideDataStatus": "NONE",
      "pageCategories": [
        "Entertainment website"
      ],
      "pageProfileUri": "https://www.facebook.com/100084043506456/",
      "isDeemedFinserv": false,
      "totalActiveTime": 0,
      "impressionsIndex": -1,
      "isLimitedDelivery": false,
      "pageProfilePicture": "https://scontent-cgk1-2.xx.fbcdn.net/v/t39.35426-6/592401388_1213371510674366_6272704253845623525_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=UR8hSSfxjD…",
      "publisherPlatforms": [
        "FACEBOOK",
        "INSTAGRAM"
      ],
      "containsSensitiveContent": false,
      "containsDigitalCreatedMedia": false
    },
    {
      "adId": "1467086034588369",
      "body": "☀️ Hyalu-Cica Sun Serum💦\n\n🌞 Bosan dengan sunscreen yang berat & berminyak?\n💧 Kenalan dengan Hyalu-Cica Sun Serum – super ringan\n🌿 Menenangkan sekaligus melindungi kulitmu\n✨ Hid…",
      "title": "Kenalan dengan SPF bertekstur serum dengan Hyaluronic Acid + Centella 💧🌿",
      "images": [
        {
          "resized": "https://scontent-cgk2-1.xx.fbcdn.net/v/t39.35426-6/547029657_806846078458621_5391690597991107197_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=pOCVM0v3I…",
          "original": "https://scontent-cgk2-2.xx.fbcdn.net/v/t39.35426-6/549684040_1852220305726593_3197933653829138351_n.jpg?_nc_cat=101&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=9cWGxNuckqIQ7kNvwHnazhx&_nc_oc=Ad…"
        }
      ],
      "pageId": "106338831229463",
      "caption": "fb.com",
      "ctaText": "Learn more",
      "ctaType": "LEARN_MORE",
      "endDate": 1788246000,
      "linkUrl": "https://fb.com/canvas_doc/1324738395757656",
      "isActive": true,
      "pageName": "SKIN1004_Indonesia",
      "gatedType": "ELIGIBLE",
      "startDate": 1776927600,
      "categories": [
        "UNKNOWN"
      ],
      "extraLinks": [
        "https://shopee.co.id/universal-link/product/555954448/16581227588?deep_and_web=1&smtt=9&utm_source=facebook-ca&utm_medium=seller&utm_campaign=s555954448_ss_id_fbca_pur_ua_id&utm_co…"
      ],
      "isReshared": false,
      "extraImages": [
        {
          "resized": "https://scontent-cgk1-2.xx.fbcdn.net/v/t39.35426-6/547254244_1524628555381004_1322088775011156713_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=mL11pPfc…",
          "original": "https://scontent-cgk1-2.xx.fbcdn.net/v/t39.35426-6/547254244_1524628555381004_1322088775011156713_n.jpg?_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=mL11pPfcYSAQ7kNvwE98inJ&_nc_oc=Ad…"
        }
      ],
      "reportCount": 0,
      "displayFormat": "IMAGE",
      "isAaaEligible": false,
      "pageIsDeleted": false,
      "pageLikeCount": 16877,
      "collationCount": 0,
      "hideDataStatus": "NONE",
      "pageCategories": [
        "Shopping"
      ],
      "pageProfileUri": "https://www.facebook.com/SKIN1004IndoneniaOfficial/",
      "isDeemedFinserv": false,
      "totalActiveTime": 0,
      "impressionsIndex": -1,
      "isLimitedDelivery": false,
      "pageProfilePicture": "https://scontent-cgk1-2.xx.fbcdn.net/v/t39.35426-6/547252848_1513835472953242_4095195998462536114_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=uVCNEnn0d1…",
      "publisherPlatforms": [
        "FACEBOOK",
        "INSTAGRAM"
      ],
      "containsSensitiveContent": false,
      "containsDigitalCreatedMedia": false
    }
  ],
  "count": 30,
  "query": "skincare",
  "total": 17395,
  "country": "ID",
  "pageSize": 30,
  "matchType": "unordered",
  "mediaType": "all",
  "activeStatus": "active"
}

Code examples

Search ads
zpi-sdkrecommended
// npm i zpi-sdk
import { ZpiClient } from "zpi-sdk";

const client = new ZpiClient({ apiKey: "zpi_xxxxxxxxxxxxxxxxxxxxxxxx" });

const data = await client.run("ads:meta", "search", {
  "query": "skincare",
  "country": "ID",
  "matchType": "unordered",
  "activeStatus": "active",
  "mediaType": "video",
  "adType": "all"
});
console.log(data);
Full SDK reference →
request.sh
curl -X GET "https://api.zpi.web.id/v1/ads:meta/search?query=skincare&country=ID&matchType=unordered&activeStatus=active&mediaType=video&adType=all" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Full reference

3 endpoints · plain text
GETSearch ads/v1/ads:meta/searchSearch the Ad Library by keyword across an entire country.

Parameters

querystringrequired
Keyword to search ad copy and advertiser names for
countrystringoptional
ISO 3166-1 alpha-2 country the ads were delivered in. Default ID
matchTypeenumoptional
Keyword matching. exact requires the phrase verbatim. Default unordered Values: unordered, exact.
activeStatusenumoptional
Delivery status of the ads. Default active Values: active, inactive, all.
mediaTypeenumoptional
Creative format filter. Default all Values: all, image, meme, image_and_meme, video, none.
adTypeenumoptional
Ad category. Default all Values: all, political_and_issue_ads.

Request

curl -X GET "https://api.zpi.web.id/v1/ads:meta/search?query=skincare&country=ID&matchType=unordered&activeStatus=active&mediaType=video&adType=all" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "ads": [
    {
      "adId": "978481707850213",
      "body": "Riapri TikTok oggi",
      "cards": [
        {
          "body": "Riapri TikTok oggi",
          "image": "https://scontent-cgk2-2.xx.fbcdn.net/v/t39.35426-6/592955169_835898305822436_5225486659854474314_n.jpg?_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=MpNFFt8dEU0Q7kNvwGd1LRI&_nc_oc=Ado…",
          "title": "Il tuo feed si è rinfrescato con contenuti che ti piacciono",
          "caption": "tiktok.com",
          "ctaText": "Learn More",
          "ctaType": "LEARN_MORE",
          "linkUrl": "https://www.tiktok.com/",
          "imageResized": "https://scontent-cgk2-2.xx.fbcdn.net/v/t39.35426-6/592955169_835898305822436_5225486659854474314_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=MpNFFt8dE…",
          "linkDescription": "TikTok - trends start here. On a device or on the web, viewers can watch and discover millions of personalized short videos. Download the app to get started."
        },
        {
          "body": "Riapri TikTok oggi",
          "image": "https://scontent-cgk1-2.xx.fbcdn.net/v/t39.35426-6/592570064_25465287146437403_807408166371539269_n.jpg?_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=N4Ztfy4avY4Q7kNvwEJuoAx&_nc_oc=Ad…",
          "title": "Il tuo feed si è rinfrescato con contenuti che ti piacciono",
          "caption": "tiktok.com",
          "ctaText": "Learn More",
          "ctaType": "LEARN_MORE",
          "linkUrl": "https://www.tiktok.com/",
          "imageResized": "https://scontent-cgk1-2.xx.fbcdn.net/v/t39.35426-6/592570064_25465287146437403_807408166371539269_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=N4Ztfy4a…",
          "linkDescription": "TikTok - trends start here. On a device or on the web, viewers can watch and discover millions of personalized short videos. Download the app to get started."
        }
      ],
      "title": "Il tuo feed si è rinfrescato con contenuti che ti piacciono",
      "pageId": "101039196037152",
      "caption": "tiktok.com",
      "ctaText": "Learn more",
      "ctaType": "LEARN_MORE",
      "endDate": 1788332400,
      "linkUrl": "http://www.tiktok.com/",
      "isActive": true,
      "pageName": "TikTok - EU",
      "gatedType": "ELIGIBLE",
      "startDate": 1776841200,
      "categories": [
        "UNKNOWN"
      ],
      "isReshared": false,
      "reportCount": 0,
      "displayFormat": "DPA",
      "isAaaEligible": true,
      "pageIsDeleted": false,
      "pageLikeCount": 45901,
      "collationCount": 0,
      "hideDataStatus": "NONE",
      "pageCategories": [
        "Entertainment website"
      ],
      "pageProfileUri": "https://www.facebook.com/100084043506456/",
      "isDeemedFinserv": false,
      "totalActiveTime": 0,
      "impressionsIndex": -1,
      "isLimitedDelivery": false,
      "pageProfilePicture": "https://scontent-cgk1-2.xx.fbcdn.net/v/t39.35426-6/592401388_1213371510674366_6272704253845623525_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=UR8hSSfxjD…",
      "publisherPlatforms": [
        "FACEBOOK",
        "INSTAGRAM"
      ],
      "containsSensitiveContent": false,
      "containsDigitalCreatedMedia": false
    },
    {
      "adId": "1467086034588369",
      "body": "☀️ Hyalu-Cica Sun Serum💦\n\n🌞 Bosan dengan sunscreen yang berat & berminyak?\n💧 Kenalan dengan Hyalu-Cica Sun Serum – super ringan\n🌿 Menenangkan sekaligus melindungi kulitmu\n✨ Hid…",
      "title": "Kenalan dengan SPF bertekstur serum dengan Hyaluronic Acid + Centella 💧🌿",
      "images": [
        {
          "resized": "https://scontent-cgk2-1.xx.fbcdn.net/v/t39.35426-6/547029657_806846078458621_5391690597991107197_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=pOCVM0v3I…",
          "original": "https://scontent-cgk2-2.xx.fbcdn.net/v/t39.35426-6/549684040_1852220305726593_3197933653829138351_n.jpg?_nc_cat=101&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=9cWGxNuckqIQ7kNvwHnazhx&_nc_oc=Ad…"
        }
      ],
      "pageId": "106338831229463",
      "caption": "fb.com",
      "ctaText": "Learn more",
      "ctaType": "LEARN_MORE",
      "endDate": 1788246000,
      "linkUrl": "https://fb.com/canvas_doc/1324738395757656",
      "isActive": true,
      "pageName": "SKIN1004_Indonesia",
      "gatedType": "ELIGIBLE",
      "startDate": 1776927600,
      "categories": [
        "UNKNOWN"
      ],
      "extraLinks": [
        "https://shopee.co.id/universal-link/product/555954448/16581227588?deep_and_web=1&smtt=9&utm_source=facebook-ca&utm_medium=seller&utm_campaign=s555954448_ss_id_fbca_pur_ua_id&utm_co…"
      ],
      "isReshared": false,
      "extraImages": [
        {
          "resized": "https://scontent-cgk1-2.xx.fbcdn.net/v/t39.35426-6/547254244_1524628555381004_1322088775011156713_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=mL11pPfc…",
          "original": "https://scontent-cgk1-2.xx.fbcdn.net/v/t39.35426-6/547254244_1524628555381004_1322088775011156713_n.jpg?_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=mL11pPfcYSAQ7kNvwE98inJ&_nc_oc=Ad…"
        }
      ],
      "reportCount": 0,
      "displayFormat": "IMAGE",
      "isAaaEligible": false,
      "pageIsDeleted": false,
      "pageLikeCount": 16877,
      "collationCount": 0,
      "hideDataStatus": "NONE",
      "pageCategories": [
        "Shopping"
      ],
      "pageProfileUri": "https://www.facebook.com/SKIN1004IndoneniaOfficial/",
      "isDeemedFinserv": false,
      "totalActiveTime": 0,
      "impressionsIndex": -1,
      "isLimitedDelivery": false,
      "pageProfilePicture": "https://scontent-cgk1-2.xx.fbcdn.net/v/t39.35426-6/547252848_1513835472953242_4095195998462536114_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=uVCNEnn0d1…",
      "publisherPlatforms": [
        "FACEBOOK",
        "INSTAGRAM"
      ],
      "containsSensitiveContent": false,
      "containsDigitalCreatedMedia": false
    }
  ],
  "count": 30,
  "query": "skincare",
  "total": 17395,
  "country": "ID",
  "pageSize": 30,
  "matchType": "unordered",
  "mediaType": "all",
  "activeStatus": "active"
}
GETAds by advertiser/v1/ads:meta/advertiser-ads/:pageIdEvery ad one Facebook page is currently running.

Parameters

pageIdstringrequiredin path
Facebook page ID of the advertiser, from the search endpoint's pageId
countrystringoptional
ISO 3166-1 alpha-2 country the ads were delivered in. Default ID
activeStatusenumoptional
Delivery status of the ads. Default active Values: active, inactive, all.
mediaTypeenumoptional
Creative format filter. Default all Values: all, image, meme, image_and_meme, video, none.
adTypeenumoptional
Ad category. Default all Values: all, political_and_issue_ads.

Request

curl -X GET "https://api.zpi.web.id/v1/ads:meta/advertiser-ads/101039196037152?country=ID&activeStatus=active&mediaType=video&adType=all" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "ads": [
    {
      "adId": "1201933001802999",
      "body": "Scorri un mondo di intrattenimento infinito, solo su TikTok",
      "cards": [
        {
          "body": "Scorri un mondo di intrattenimento infinito, solo su TikTok",
          "image": "https://scontent-cgk1-2.xx.fbcdn.net/v/t39.35426-6/582065307_1537419397293914_814462689383364053_n.jpg?_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=XfFVGMqy1NQQ7kNvwH8SKSR&_nc_oc=Adq…",
          "title": "TikTok - Videos, Shop & LIVE - Apps on Google Play",
          "caption": "play.google.com",
          "ctaText": "Download",
          "ctaType": "DOWNLOAD",
          "linkUrl": "https://www.tiktok.com/",
          "imageResized": "https://scontent-cgk1-2.xx.fbcdn.net/v/t39.35426-6/582065307_1537419397293914_814462689383364053_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=XfFVGMqy1…",
          "linkDescription": "Join your friends and discover videos you love, only on TikTok"
        },
        {
          "body": "Scorri un mondo di intrattenimento infinito, solo su TikTok",
          "image": "https://scontent-cgk2-2.xx.fbcdn.net/v/t39.35426-6/581731865_1390442412452861_3547426849243737041_n.jpg?_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Ah9GEtzG06kQ7kNvwHM8VDs&_nc_oc=Ad…",
          "title": "TikTok - Videos, Shop & LIVE - Apps on Google Play",
          "caption": "play.google.com",
          "ctaText": "Download",
          "ctaType": "DOWNLOAD",
          "linkUrl": "https://www.tiktok.com/",
          "imageResized": "https://scontent-cgk2-2.xx.fbcdn.net/v/t39.35426-6/581731865_1390442412452861_3547426849243737041_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Ah9GEtzG…",
          "linkDescription": "Join your friends and discover videos you love, only on TikTok"
        }
      ],
      "title": "TikTok - Videos, Shop & LIVE",
      "caption": "play.google.com",
      "ctaText": "Download",
      "ctaType": "DOWNLOAD",
      "endDate": 1788332400,
      "linkUrl": "http://play.google.com/store/apps/details?id=com.zhiliaoapp.musically",
      "isActive": true,
      "startDate": 1763107200,
      "categories": [
        "UNKNOWN"
      ],
      "reportCount": 0,
      "displayFormat": "DPA",
      "collationCount": 0,
      "totalActiveTime": 0,
      "impressionsIndex": -1,
      "publisherPlatforms": [
        "FACEBOOK",
        "INSTAGRAM"
      ],
      "containsSensitiveContent": false,
      "containsDigitalCreatedMedia": false
    },
    {
      "adId": "1167498484932939",
      "body": "Scorri un mondo di intrattenimento infinito, solo su TikTok",
      "cards": [
        {
          "body": "Scorri un mondo di intrattenimento infinito, solo su TikTok",
          "image": "https://scontent-cgk2-1.xx.fbcdn.net/v/t39.35426-6/581938746_1895111804758285_6665172458856455615_n.jpg?_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=1L2gaMS5VEoQ7kNvwE7J3kn&_nc_oc=Ad…",
          "title": "Scopri la magia di TikTok",
          "caption": "play.google.com",
          "ctaText": "Download",
          "ctaType": "DOWNLOAD",
          "linkUrl": "https://www.tiktok.com/",
          "imageResized": "https://scontent-cgk2-1.xx.fbcdn.net/v/t39.35426-6/581938746_1895111804758285_6665172458856455615_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=1L2gaMS5…",
          "linkDescription": "Join your friends and discover videos you love, only on TikTok"
        },
        {
          "body": "Scorri un mondo di intrattenimento infinito, solo su TikTok",
          "image": "https://scontent-cgk1-2.xx.fbcdn.net/v/t39.35426-6/583221475_624214347444471_6827425103835153825_n.jpg?_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=fuJ9X5_1KVEQ7kNvwGvXzOl&_nc_oc=Adp…",
          "title": "Scopri la magia di TikTok",
          "caption": "play.google.com",
          "ctaText": "Download",
          "ctaType": "DOWNLOAD",
          "linkUrl": "https://www.tiktok.com/",
          "imageResized": "https://scontent-cgk1-2.xx.fbcdn.net/v/t39.35426-6/583221475_624214347444471_6827425103835153825_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=fuJ9X5_1K…",
          "linkDescription": "Join your friends and discover videos you love, only on TikTok"
        }
      ],
      "title": "{{product.name}}",
      "caption": "play.google.com",
      "ctaText": "Download",
      "ctaType": "DOWNLOAD",
      "endDate": 1788332400,
      "linkUrl": "http://play.google.com/store/apps/details?id=com.zhiliaoapp.musically",
      "isActive": true,
      "startDate": 1763107200,
      "categories": [
        "UNKNOWN"
      ],
      "reportCount": 0,
      "displayFormat": "DPA",
      "collationCount": 0,
      "totalActiveTime": 0,
      "impressionsIndex": -1,
      "publisherPlatforms": [
        "FACEBOOK",
        "INSTAGRAM"
      ],
      "containsSensitiveContent": false,
      "containsDigitalCreatedMedia": false
    }
  ],
  "count": 30,
  "total": 46,
  "pageId": "101039196037152",
  "country": "ID",
  "pageName": "TikTok - EU",
  "pageSize": 30,
  "mediaType": "all",
  "activeStatus": "active",
  "pageLikeCount": 45901,
  "pageCategories": [
    "Entertainment website"
  ],
  "pageProfileUri": "https://www.facebook.com/100084043506456/"
}
GETAd detail/v1/ads:meta/ad-detail/:adIdOne ad with its full creative snapshot, carousel cards and media.

Parameters

adIdstringrequiredin path
Ad Library ID, from the search endpoint's adId

Request

curl -X GET "https://api.zpi.web.id/v1/ads:meta/ad-detail/978481707850213" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "adId": "978481707850213",
  "body": "Riapri TikTok oggi",
  "cards": [
    {
      "body": "Riapri TikTok oggi",
      "image": "https://scontent-cgk2-1.xx.fbcdn.net/v/t39.35426-6/592483415_4234700246815127_2725760277796612195_n.jpg?_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=P7LpTXH2RN4Q7kNvwEJblZS&_nc_oc=Ad…",
      "title": "Il tuo feed si è rinfrescato con contenuti che ti piacciono",
      "caption": "tiktok.com",
      "ctaText": "Learn More",
      "ctaType": "LEARN_MORE",
      "linkUrl": "https://www.tiktok.com/",
      "imageResized": "https://scontent-cgk2-1.xx.fbcdn.net/v/t39.35426-6/592483415_4234700246815127_2725760277796612195_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=P7LpTXH2…",
      "linkDescription": "TikTok - trends start here. On a device or on the web, viewers can watch and discover millions of personalized short videos. Download the app to get started."
    },
    {
      "body": "Riapri TikTok oggi",
      "image": "https://scontent-cgk2-1.xx.fbcdn.net/v/t39.35426-6/592903956_1641967966964390_8320276372231565093_n.jpg?_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=43XJQ26zibcQ7kNvwFWlaEk&_nc_oc=Ad…",
      "title": "Il tuo feed si è rinfrescato con contenuti che ti piacciono",
      "caption": "tiktok.com",
      "ctaText": "Learn More",
      "ctaType": "LEARN_MORE",
      "linkUrl": "https://www.tiktok.com/",
      "imageResized": "https://scontent-cgk2-1.xx.fbcdn.net/v/t39.35426-6/592903956_1641967966964390_8320276372231565093_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=43XJQ26z…",
      "linkDescription": "TikTok - trends start here. On a device or on the web, viewers can watch and discover millions of personalized short videos. Download the app to get started."
    },
    {
      "body": "Riapri TikTok oggi",
      "image": "https://scontent-cgk1-2.xx.fbcdn.net/v/t39.35426-6/592570064_25465287146437403_807408166371539269_n.jpg?_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=N4Ztfy4avY4Q7kNvwEJuoAx&_nc_oc=Ad…",
      "title": "Il tuo feed si è rinfrescato con contenuti che ti piacciono",
      "caption": "tiktok.com",
      "ctaText": "Learn More",
      "ctaType": "LEARN_MORE",
      "linkUrl": "https://www.tiktok.com/",
      "imageResized": "https://scontent-cgk1-2.xx.fbcdn.net/v/t39.35426-6/592570064_25465287146437403_807408166371539269_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=N4Ztfy4a…",
      "linkDescription": "TikTok - trends start here. On a device or on the web, viewers can watch and discover millions of personalized short videos. Download the app to get started."
    }
  ],
  "title": "Il tuo feed si è rinfrescato con contenuti che ti piacciono",
  "pageId": "101039196037152",
  "caption": "tiktok.com",
  "ctaText": "Learn more",
  "ctaType": "LEARN_MORE",
  "endDate": 1788332400,
  "linkUrl": "http://www.tiktok.com/",
  "isActive": true,
  "pageName": "TikTok - EU",
  "gatedType": "ELIGIBLE",
  "startDate": 1776841200,
  "categories": [
    "UNKNOWN"
  ],
  "isReshared": false,
  "reportCount": 0,
  "displayFormat": "DPA",
  "isAaaEligible": true,
  "pageIsDeleted": false,
  "pageLikeCount": 45901,
  "collationCount": 0,
  "hideDataStatus": "NONE",
  "pageCategories": [
    "Entertainment website"
  ],
  "pageProfileUri": "https://www.facebook.com/100084043506456/",
  "isDeemedFinserv": false,
  "totalActiveTime": 0,
  "isLimitedDelivery": false,
  "pageProfilePicture": "https://scontent-cgk1-2.xx.fbcdn.net/v/t39.35426-6/592401388_1213371510674366_6272704253845623525_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=UR8hSSfxjD…",
  "publisherPlatforms": [
    "FACEBOOK",
    "INSTAGRAM",
    "AUDIENCE_NETWORK"
  ],
  "containsSensitiveContent": false,
  "containsDigitalCreatedMedia": false
}

Related APIs

More in ads

Google Ads Transparency

ads/google-ads

Advertisers and creatives from Google's Ads Transparency Center — Search, YouTube, Maps, Play and Shopping, across 244 regions.

130 calls·5m cache
Browse APIsPricingDocsMCP serverGet an API key
zapi.One key, one response shape.
TermsPrivacyCookiesAUPRefunds© 2026