{
"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/14875/european+dsa+ad+reach+and+demographics+data+api/38717/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/14875/european+dsa+ad+reach+and+demographics+data+api/38718/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/14875/european+dsa+ad+reach+and+demographics+data+api/38719/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/14875/european+dsa+ad+reach+and+demographics+data+api/38720/resolve+page+or+instagram+handle+to+advertiser?target=@loungebyzalando' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 欧洲DSA广告覆盖范围和人口统计数据 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
是的。与官方的Graph API广告归档端点(该端点将商业广告限制在欧盟和英国)不同,此API提取包括美国 加拿大 澳大利亚 巴西 新加坡以及全球所有200多个国家的活跃和非活跃商业广告
是的 视频广告包括在primaryVideoHdUrl primaryVideoSdUrl videoHdUrls和videoPreviewImageUrl中的直接CDN视频流 而图片和轮播广告包括primaryImageUrl imageUrls和结构化卡片
传递Instagram账号(例如@loungebyzalando)、数字页面ID或Facebook页面链接到“通过页面或Instagram账号获取竞争对手广告”的目标参数中。API会自动解析规范的数字pageId
在欧盟/欧洲经济区成员国(根据数字服务法)和英国(国家=德、法、荷、西、意、英或英国)投放的广告包括euTotalReach、euAgeMin、euAgeMax、euGenderAudience、付款人、受益人和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 totalCount returnedCount activeStatus euTotalReach 和人口统计细分(euAgeMin euAgeMax euGenderAudience)这些字段提供了关于广告表现和受众定位的基本洞察
参数因端点而异,但一般包括目标(针对竞争对手广告)、国家、广告类型、媒体类型和日期范围。用户可以通过指定这些参数来自定义请求,以根据他们的需求过滤结果
响应数据采用JSON格式结构,包含一个"meta"部分,其中包含请求详细信息,以及一个"data"部分,存放相关的广告信息。每个广告的详细信息被封装在一个"items"数组中,以便轻松访问多个广告
每个端点提供不同的见解:“搜索元广告”端点提供对广告的广泛搜索,而“获取单个广告创意”则专注于特定广告的详细指标。信息包括广告创意、覆盖范围、人口统计和参与度指标
用户可以分析返回的数据以评估广告效果 理解受众人口统计信息 并比较竞争对手的策略 例如 营销人员可以利用人口统计洞察来调整他们的广告活动或识别广告工作中的差距
典型的使用案例包括竞争分析受众定位优化和活动绩效评估企业可以跟踪竞争对手的广告以根据人口统计洞察来完善他们的策略并改善参与度
数据准确性通过来自Meta广告平台的定期更新以及遵守欧盟广告的数字服务法案来保持。API直接从Meta广告库提取数据,确保用户获得可靠和最新的信息