{
"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/14872/meta+ads+library+competitor+ad+spy+api/38705/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/14872/meta+ads+library+competitor+ad+spy+api/38706/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/14872/meta+ads+library+competitor+ad+spy+api/38707/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/14872/meta+ads+library+competitor+ad+spy+api/38708/resolve+page+or+instagram+handle+to+advertiser?target=@loungebyzalando' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 Meta广告库竞争对手广告间谍 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会自动解析规范的数字pageId
在欧洲联盟/欧洲经济区成员国(根据数字服务法)和英国(国家=DE FR NL ES IT GB或UK投放的广告包括欧盟总覆盖、欧盟最小年龄、欧盟最大年龄、欧盟性别受众、支付者、受益者和欧盟覆盖细分
Meta 发布支出和展示范围(spendLower spendUpper spendText impressionsLower impressionsUpper currency 和 byline)用于受监管的政治和社会议题广告(设置 ad_type=political_and_issue_ads)。对于商业美国广告,请使用 activeDays 和 collationCount
当上游有更多广告可用时,响应包括hasNextPage=true和一个加密的nextCursor令牌(以ma1_为前缀)在你的下一个请求中传递cursor=ma1_...以获取后续页面,并确保没有重复记录