{
"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/14873/competitor+ad+spy+and+video+creatives+data+api/38709/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/14873/competitor+ad+spy+and+video+creatives+data+api/38710/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/14873/competitor+ad+spy+and+video+creatives+data+api/38711/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/14873/competitor+ad+spy+and+video+creatives+data+api/38712/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 访问密钥"。
|
在200个国家以JSON格式检索数字营销广告创意 MP4视频流 旋转卡片和广告商活动元数据
是的。与官方的Graph API ads_archive端点(将商业广告限制在欧盟和英国)不同,此API提取了包括美国 加拿大 澳大利亚 巴西 新加坡以及全球所有200多个国家的活跃和非活跃商业广告
是的 视频广告包含在primaryVideoHdUrl primaryVideoSdUrl videoHdUrls和videoPreviewImageUrl中的直接CDN视频流 而图像和旋转木马广告包含primaryImageUrl imageUrls和结构化卡片
在获取竞争对手广告时,请将Instagram账号(例如@loungebyzalando)、数字页面ID或Facebook页面链接传递到目标参数中。API会自动解析规范的数字pageId
在欧洲联盟/欧洲经济区成员国(根据数字服务法)和英国(国家=DE,FR,NL,ES,IT,GB或UK)投放的广告包括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和一个以ma1_为前缀的加密nextCursor令牌。在您的下一个请求中传递cursor=ma1_...以检索后续页面且没有重复记录
每个端点返回各种类型的数字营销数据,包括广告创意视频流轮播卡片和广告主活动元数据。例如“获取竞争对手广告”端点提供活动或历史广告而“搜索元广告库”端点允许对多个国家进行实时搜索
关键字段包括 adArchiveId、adUrl、activeStatus、startDate、endDate 和受众人口统计信息。例如,“获取单个广告创意”端点包括如 isActive、pageId 和 activeDays 等字段,提供广告表现和覆盖面的洞察
响应数据采用JSON格式构建,包括一个包含请求详情的"meta"部分和一个包含实际结果的"data"部分。每个广告的详情都封装在一个"items"数组中,便于访问多个记录
参数因端点而异,但通常包括交付状态、广告类型、媒体类型、语言和日期范围等过滤器。例如“搜索元广告库”允许通过准确短语和位置来过滤以细化搜索结果
每个端点提供具体的信息例如“获取竞争对手广告”返回竞争对手投放的广告而“获取单个广告创意”提供有关特定广告表现的详细 insights 包括覆盖率和消费数据
用户可以通过指定国家、广告类型和日期范围等参数来自定义请求。例如,在“搜索元广告库”中,用户可以过滤结果,以仅显示特定国家或语言的活动广告
数据准确性通过Meta广告库的定期更新和数据检索期间的验证检查来维护 API直接从Meta的广告平台提取数据 确保反映最新的信息
典型的用例包括竞争分析 市场研究 和广告效果跟踪 市场营销人员可以分析竞争对手策略 评估广告效果 并识别不同地区数字广告的趋势