{
"success": true,
"meta": {
"request_id": "req_9a8b7c6d5e4f",
"plugin": "meta-ads",
"endpoint": "search",
"tier": "PRO",
"cached": false,
"latency_ms": 312.4,
"timestamp": "2026-11-10T20:00:00+00:00"
},
"data": {
"query": "Nordic Athletic",
"country": "DE",
"activeStatus": "ACTIVE",
"adType": "ALL",
"mediaType": "ALL",
"sortBy": "relevancy",
"totalCount": 142,
"returnedCount": 1,
"hasNextPage": true,
"nextCursor": "ma1_dGVzdF9zYW1wbGVfY3Vyc29yX3Yx",
"items": [
{
"adArchiveId": "894480703382759",
"adUrl": "https://www.facebook.com/ads/library/?id=894480703382759",
"collationId": "1209841029384",
"collationCount": 3,
"isActive": true,
"startDate": "2026-09-15T08:00:00+00:00",
"endDate": null,
"startTimestamp": 1789459200,
"endTimestamp": null,
"activeDays": 56.5,
"isLongRunningWinner": true,
"pageId": "20409006880",
"pageName": "Nordic Athletic Apparel",
"pageUrl": "https://www.facebook.com/20409006880",
"pageAlias": "nordicathletic",
"pageCategory": "Clothing (Brand)",
"pageLikes": 482900,
"pageAbout": "Performance running footwear and technical apparel engineered for all seasons.",
"pageProfilePictureUrl": "https://scontent.xx.fbcdn.net/v/t39.30808-1/sample_brand_avatar.jpg",
"pageCoverPhotoUrl": "https://scontent.xx.fbcdn.net/v/t39.30808-6/sample_brand_cover.jpg",
"pageIsDeleted": false,
"igUsername": "nordicathletic_eu",
"igUrl": "https://www.instagram.com/nordicathletic_eu/",
"igFollowers": 318400,
"igVerified": true,
"displayFormat": "VIDEO",
"publisherPlatforms": [
"FACEBOOK",
"INSTAGRAM"
],
"publisherPlatformsText": "FACEBOOK, INSTAGRAM",
"categories": [],
"title": "Autumn Trail Series — Waterproof GORE-TEX Runners",
"bodyText": "Engineered for wet trails and cold mornings. Free express EU shipping & 30-day trail guarantee.",
"caption": "nordicathletic.example",
"linkDescription": "Shop the new Autumn Trail Series collection.",
"ctaText": "Shop Now",
"ctaType": "SHOP_NOW",
"linkUrl": "https://nordicathletic.example/collections/trail-series",
"linkDomain": "nordicathletic.example",
"containsAiCreatedMedia": false,
"primaryImageUrl": "https://scontent.xx.fbcdn.net/v/t39.35426-6/sample_ad_frame.jpg",
"primaryVideoHdUrl": "https://video.xx.fbcdn.net/v/t42.1790-2/sample_creative_hd.mp4",
"primaryVideoSdUrl": "https://video.xx.fbcdn.net/v/t42.1790-2/sample_creative_sd.mp4",
"videoPreviewImageUrl": "https://scontent.xx.fbcdn.net/v/t39.35426-6/sample_ad_preview.jpg",
"imageCount": 1,
"videoCount": 1,
"cardCount": 0,
"imageUrls": [
"https://scontent.xx.fbcdn.net/v/t39.35426-6/sample_ad_frame.jpg"
],
"videoHdUrls": [
"https://video.xx.fbcdn.net/v/t42.1790-2/sample_creative_hd.mp4"
],
"videoSdUrls": [
"https://video.xx.fbcdn.net/v/t42.1790-2/sample_creative_sd.mp4"
],
"carouselCards": [],
"byline": null,
"disclaimerLabel": null,
"currency": null,
"spendText": null,
"spendLower": null,
"spendUpper": null,
"impressionsText": null,
"impressionsLower": null,
"impressionsUpper": null,
"reachEstimateText": null,
"isPoliticalPage": false,
"pageLifetimePoliticalSpend": null,
"isAaaEligible": true,
"payer": "Nordic Athletic GmbH",
"beneficiary": "Nordic Athletic GmbH",
"euTargetsEu": true,
"euTotalReach": 148520,
"euGenderAudience": "All",
"euAgeMin": 18,
"euAgeMax": 65,
"euTargetLocations": [
"Germany",
"Austria",
"Netherlands"
],
"euLocationCountriesText": "Germany, Austria, Netherlands",
"euAgeGenderBreakdown": [
{
"country": "DE",
"ageRange": "25-34",
"male": 28410,
"female": 31290,
"unknown": 410,
"total": 60110
},
{
"country": "DE",
"ageRange": "35-44",
"male": 22150,
"female": 24800,
"unknown": 310,
"total": 47260
},
{
"country": "NL",
"ageRange": "25-34",
"male": 19400,
"female": 21500,
"unknown": 250,
"total": 41150
}
],
"countryFilter": "DE",
"searchQuery": "demo_eu_dsa_ad_01",
"inputSource": "ad_id",
"detailLevel": "full",
"scrapedAt": "2026-11-10T20:00:00+00:00"
}
]
}
}
curl --location --request GET 'https://zylalabs.com/api/14876/political+and+issue+ad+spend+transparency+api/38721/search+meta+ads+library+by+keyword+and+filters?query=Shopify&country=US&active_status=active&ad_type=all&media_type=all&search_type=keyword_unordered&sort_by=relevancy&include_details=true&page_size=10' --header 'Authorization: Bearer YOUR_API_KEY'
{
"success": true,
"meta": {
"request_id": "req_1f2e3d4c5b6a",
"plugin": "meta-ads",
"endpoint": "page-ads",
"tier": "PRO",
"cached": false,
"latency_ms": 298.1,
"timestamp": "2026-11-10T20:00:00+00:00"
},
"data": {
"target": "https://www.facebook.com/nordicathletic",
"pageId": "20409006880",
"pageName": "Nordic Athletic Apparel",
"igUsername": "nordicathletic_eu",
"igFollowers": 318400,
"country": "ALL",
"activeStatus": "ACTIVE",
"totalCount": 142,
"returnedCount": 1,
"hasNextPage": true,
"nextCursor": "ma1_cGFnZV9zYW1wbGVfY3Vyc29yX3Yx",
"items": [
{
"adArchiveId": "894480703382759",
"adUrl": "https://www.facebook.com/ads/library/?id=894480703382759",
"collationId": "1209841029384",
"collationCount": 3,
"isActive": true,
"startDate": "2026-09-15T08:00:00+00:00",
"endDate": null,
"startTimestamp": 1789459200,
"endTimestamp": null,
"activeDays": 56.5,
"isLongRunningWinner": true,
"pageId": "20409006880",
"pageName": "Nordic Athletic Apparel",
"pageUrl": "https://www.facebook.com/20409006880",
"pageAlias": "nordicathletic",
"pageCategory": "Clothing (Brand)",
"pageLikes": 482900,
"pageAbout": "Performance running footwear and technical apparel engineered for all seasons.",
"pageProfilePictureUrl": "https://scontent.xx.fbcdn.net/v/t39.30808-1/sample_brand_avatar.jpg",
"pageCoverPhotoUrl": "https://scontent.xx.fbcdn.net/v/t39.30808-6/sample_brand_cover.jpg",
"pageIsDeleted": false,
"igUsername": "nordicathletic_eu",
"igUrl": "https://www.instagram.com/nordicathletic_eu/",
"igFollowers": 318400,
"igVerified": true,
"displayFormat": "VIDEO",
"publisherPlatforms": [
"FACEBOOK",
"INSTAGRAM"
],
"publisherPlatformsText": "FACEBOOK, INSTAGRAM",
"categories": [],
"title": "Autumn Trail Series — Waterproof GORE-TEX Runners",
"bodyText": "Engineered for wet trails and cold mornings. Free express EU shipping & 30-day trail guarantee.",
"caption": "nordicathletic.example",
"linkDescription": "Shop the new Autumn Trail Series collection.",
"ctaText": "Shop Now",
"ctaType": "SHOP_NOW",
"linkUrl": "https://nordicathletic.example/collections/trail-series",
"linkDomain": "nordicathletic.example",
"containsAiCreatedMedia": false,
"primaryImageUrl": "https://scontent.xx.fbcdn.net/v/t39.35426-6/sample_ad_frame.jpg",
"primaryVideoHdUrl": "https://video.xx.fbcdn.net/v/t42.1790-2/sample_creative_hd.mp4",
"primaryVideoSdUrl": "https://video.xx.fbcdn.net/v/t42.1790-2/sample_creative_sd.mp4",
"videoPreviewImageUrl": "https://scontent.xx.fbcdn.net/v/t39.35426-6/sample_ad_preview.jpg",
"imageCount": 1,
"videoCount": 1,
"cardCount": 0,
"imageUrls": [
"https://scontent.xx.fbcdn.net/v/t39.35426-6/sample_ad_frame.jpg"
],
"videoHdUrls": [
"https://video.xx.fbcdn.net/v/t42.1790-2/sample_creative_hd.mp4"
],
"videoSdUrls": [
"https://video.xx.fbcdn.net/v/t42.1790-2/sample_creative_sd.mp4"
],
"carouselCards": [],
"byline": null,
"disclaimerLabel": null,
"currency": null,
"spendText": null,
"spendLower": null,
"spendUpper": null,
"impressionsText": null,
"impressionsLower": null,
"impressionsUpper": null,
"reachEstimateText": null,
"isPoliticalPage": false,
"pageLifetimePoliticalSpend": null,
"isAaaEligible": true,
"payer": "Nordic Athletic GmbH",
"beneficiary": "Nordic Athletic GmbH",
"euTargetsEu": true,
"euTotalReach": 148520,
"euGenderAudience": "All",
"euAgeMin": 18,
"euAgeMax": 65,
"euTargetLocations": [
"Germany",
"Austria",
"Netherlands"
],
"euLocationCountriesText": "Germany, Austria, Netherlands",
"euAgeGenderBreakdown": [
{
"country": "DE",
"ageRange": "25-34",
"male": 28410,
"female": 31290,
"unknown": 410,
"total": 60110
},
{
"country": "DE",
"ageRange": "35-44",
"male": 22150,
"female": 24800,
"unknown": 310,
"total": 47260
},
{
"country": "NL",
"ageRange": "25-34",
"male": 19400,
"female": 21500,
"unknown": 250,
"total": 41150
}
],
"countryFilter": "DE",
"searchQuery": "demo_eu_dsa_ad_01",
"inputSource": "ad_id",
"detailLevel": "full",
"scrapedAt": "2026-11-10T20:00:00+00:00"
}
]
}
}
curl --location --request GET 'https://zylalabs.com/api/14876/political+and+issue+ad+spend+transparency+api/38722/get+competitor+ads+by+page+or+instagram+handle?target=20409006880&country=ALL&active_status=active&ad_type=all&media_type=all&sort_by=relevancy&include_details=true&page_size=10' --header 'Authorization: Bearer YOUR_API_KEY'
{
"success": true,
"meta": {
"request_id": "req_7c8d9e0f1a2b",
"plugin": "meta-ads",
"endpoint": "ad",
"tier": "PRO",
"cached": false,
"latency_ms": 245.7,
"timestamp": "2026-11-10T20:00:00+00:00"
},
"data": {
"adArchiveId": "894480703382759",
"adUrl": "https://www.facebook.com/ads/library/?id=894480703382759",
"collationId": "1209841029384",
"collationCount": 3,
"isActive": true,
"startDate": "2026-09-15T08:00:00+00:00",
"endDate": null,
"startTimestamp": 1789459200,
"endTimestamp": null,
"activeDays": 56.5,
"isLongRunningWinner": true,
"pageId": "20409006880",
"pageName": "Nordic Athletic Apparel",
"pageUrl": "https://www.facebook.com/20409006880",
"pageAlias": "nordicathletic",
"pageCategory": "Clothing (Brand)",
"pageLikes": 482900,
"pageAbout": "Performance running footwear and technical apparel engineered for all seasons.",
"pageProfilePictureUrl": "https://scontent.xx.fbcdn.net/v/t39.30808-1/sample_brand_avatar.jpg",
"pageCoverPhotoUrl": "https://scontent.xx.fbcdn.net/v/t39.30808-6/sample_brand_cover.jpg",
"pageIsDeleted": false,
"igUsername": "nordicathletic_eu",
"igUrl": "https://www.instagram.com/nordicathletic_eu/",
"igFollowers": 318400,
"igVerified": true,
"displayFormat": "VIDEO",
"publisherPlatforms": [
"FACEBOOK",
"INSTAGRAM"
],
"publisherPlatformsText": "FACEBOOK, INSTAGRAM",
"categories": [],
"title": "Autumn Trail Series — Waterproof GORE-TEX Runners",
"bodyText": "Engineered for wet trails and cold mornings. Free express EU shipping & 30-day trail guarantee.",
"caption": "nordicathletic.example",
"linkDescription": "Shop the new Autumn Trail Series collection.",
"ctaText": "Shop Now",
"ctaType": "SHOP_NOW",
"linkUrl": "https://nordicathletic.example/collections/trail-series",
"linkDomain": "nordicathletic.example",
"containsAiCreatedMedia": false,
"primaryImageUrl": "https://scontent.xx.fbcdn.net/v/t39.35426-6/sample_ad_frame.jpg",
"primaryVideoHdUrl": "https://video.xx.fbcdn.net/v/t42.1790-2/sample_creative_hd.mp4",
"primaryVideoSdUrl": "https://video.xx.fbcdn.net/v/t42.1790-2/sample_creative_sd.mp4",
"videoPreviewImageUrl": "https://scontent.xx.fbcdn.net/v/t39.35426-6/sample_ad_preview.jpg",
"imageCount": 1,
"videoCount": 1,
"cardCount": 0,
"imageUrls": [
"https://scontent.xx.fbcdn.net/v/t39.35426-6/sample_ad_frame.jpg"
],
"videoHdUrls": [
"https://video.xx.fbcdn.net/v/t42.1790-2/sample_creative_hd.mp4"
],
"videoSdUrls": [
"https://video.xx.fbcdn.net/v/t42.1790-2/sample_creative_sd.mp4"
],
"carouselCards": [],
"byline": null,
"disclaimerLabel": null,
"currency": null,
"spendText": null,
"spendLower": null,
"spendUpper": null,
"impressionsText": null,
"impressionsLower": null,
"impressionsUpper": null,
"reachEstimateText": null,
"isPoliticalPage": false,
"pageLifetimePoliticalSpend": null,
"isAaaEligible": true,
"payer": "Nordic Athletic GmbH",
"beneficiary": "Nordic Athletic GmbH",
"euTargetsEu": true,
"euTotalReach": 148520,
"euGenderAudience": "All",
"euAgeMin": 18,
"euAgeMax": 65,
"euTargetLocations": [
"Germany",
"Austria",
"Netherlands"
],
"euLocationCountriesText": "Germany, Austria, Netherlands",
"euAgeGenderBreakdown": [
{
"country": "DE",
"ageRange": "25-34",
"male": 28410,
"female": 31290,
"unknown": 410,
"total": 60110
},
{
"country": "DE",
"ageRange": "35-44",
"male": 22150,
"female": 24800,
"unknown": 310,
"total": 47260
},
{
"country": "NL",
"ageRange": "25-34",
"male": 19400,
"female": 21500,
"unknown": 250,
"total": 41150
}
],
"countryFilter": "DE",
"searchQuery": "demo_eu_dsa_ad_01",
"inputSource": "ad_id",
"detailLevel": "full",
"scrapedAt": "2026-11-10T20:00:00+00:00"
}
}
curl --location --request GET 'https://zylalabs.com/api/14876/political+and+issue+ad+spend+transparency+api/38723/get+single+ad+creative+eu+reach+and+spend?ad_id=1952066089105921&country=DE' --header 'Authorization: Bearer YOUR_API_KEY'
{
"success": true,
"meta": {
"request_id": "req_3e4f5a6b7c8d",
"plugin": "meta-ads",
"endpoint": "advertiser",
"tier": "PRO",
"cached": false,
"latency_ms": 340.2,
"timestamp": "2026-11-10T20:00:00+00:00"
},
"data": {
"target": "https://www.facebook.com/nordicathletic",
"resolvedVia": "fb_page_stream",
"pageId": "20409006880",
"pageName": "Nordic Athletic Apparel",
"pageUrl": "https://www.facebook.com/20409006880",
"adLibraryPageUrl": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=ALL&view_all_page_id=20409006880",
"pageAlias": "nordicathletic",
"pageCategory": "Clothing (Brand)",
"pageLikes": 482900,
"pageAbout": "Performance running footwear and technical apparel engineered for all seasons.",
"pageProfilePictureUrl": "https://scontent.xx.fbcdn.net/v/t39.30808-1/sample_brand_avatar.jpg",
"pageCoverPhotoUrl": "https://scontent.xx.fbcdn.net/v/t39.30808-6/sample_brand_cover.jpg",
"pageIsDeleted": false,
"igUsername": "nordicathletic_eu",
"igUrl": "https://www.instagram.com/nordicathletic_eu/",
"igFollowers": 318400,
"igVerified": true,
"isPoliticalPage": false,
"pageLifetimePoliticalSpend": null,
"totalActiveAdsCount": 142,
"scrapedAt": "2026-11-10T20:00:00+00:00"
}
}
curl --location --request GET 'https://zylalabs.com/api/14876/political+and+issue+ad+spend+transparency+api/38724/resolve+page+or+instagram+handle+to+advertiser?target=@loungebyzalando' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 政治和问题广告支出透明度 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
获取政治、选举和公共事务广告支出区间、曝光范围、资金实体和区域投放数据
是的。与官方的Graph API ads_archive端点(将商业广告限制在欧盟和英国)不同,该API提取跨越200多个国家的活跃和非活跃商业广告,包括美国、加拿大、澳大利亚、巴西、新加坡以及全球所有地区
是的 视频广告包括在primaryVideoHdUrl primaryVideoSdUrl videoHdUrls和videoPreviewImageUrl中的直接CDN视频流 而图片和轮播广告包括primaryImageUrl imageUrls和结构化卡片
在Get Competitor Ads by Page或Instagram Handle的目标参数中传递Instagram账号(如@loungebyzalando)、数字页面ID或Facebook页面链接 API会自动解析标准数字页面ID
在欧盟/欧洲经济区成员国(根据数字服务法)和英国投放的广告(国家=德、法、荷、西、意、英或英国)包括euTotalReach、euAgeMin、euAgeMax、euGenderAudience、payer、beneficiary和euReachBreakdown
Meta发布监管的政治和社会议题广告的支出和展示范围(spendLower spendUpper spendText impressionsLower impressionsUpper currency 及 byline)(设置ad_type=political_and_issue_ads)。对于商业美国广告,请使用activeDays和collationCount
当上游有更多广告可用时,响应包含hasNextPage=true和一个加密的nextCursor令牌(前缀为ma1_)将cursor=ma1_...传入您的下一个请求,以检索后续页面,避免重复记录
每个端点返回有关政治和问题广告的详细信息,包括广告支出区间、展示范围、创意格式、广告主详细信息和区域投放数据。例如,“获取竞争对手广告”端点提供特定品牌投放广告的洞察,而“获取单个广告创意”则提供个别广告的透明度细节
关键字段包括 adArchiveId adUrl activeStatus startDate endDate totalCount 和包含广告详情的 items 数组 例如 "获取单个广告创意" 接口包括 euTotalReach pageLikes 和受众人口统计等字段 提供了关于每个广告的全面洞察
参数因端点而异,但通常包括交付状态、广告类型、媒体类型、语言和日期范围等过滤条件。例如“搜索元广告库”端点允许按监管类别和创意格式进行过滤,使用户能够有效自定义其搜索
响应数据采用JSON格式结构,其中“meta”部分提供请求详情,“data”部分包含相关的广告信息。每个广告的细节被封装在“items”数组中,便于在单个响应中遍历多个广告
数据来源于Facebook和Instagram的Meta广告库,该库汇集了来自200多个国家的各种广告活动的信息。这确保了政治和议题广告的广泛覆盖,保持提供数据的相关性和准确性
典型的用例包括竞争分析跟踪政治广告支出了解受众人口统计以及评估广告表现市场营销人员和研究人员可以利用这些数据来指导策略和评估广告活动的有效性
用户可以分析返回的数据以识别广告支出、受众参与和创意效果的趋势例如通过检查euTotalReach和人口统计信息用户可以更有效地定制他们的活动以针对特定受众
如果响应显示没有结果或部分数据,用户应该检查他们的查询参数是否准确 调整过滤器或扩展日期范围可以帮助获取更全面的结果 hasNextPage的存在也可以指导用户探索其他可用的数据