竞争对手广告间谍和视频创意数据 API

API ID 14873

检索来自200个国家的数字营销广告创意 MP4视频流 轮播卡片和广告主活动元数据 以JSON格式

API 文档

端点

请求
在200多个国家或全球范围内对Facebook和Instagram Meta广告库执行实时服务器端搜索 通过投放状态 受监管类别 视频或图片创意格式 投放位置 语言 精确短语和日期范围进行筛选 返回可播放的HD MP4视频流 旋转卡片 CTA链接 广告商统计 数据 欧盟和英国覆盖率以及光标分页
Endpoint ID: 38709
GET https://zylalabs.com/api/14873/competitor+ad+spy+and+video+creatives+data+api/38709/search+meta+ads+library+by+keyword+and+filters
输入参数

按关键词和过滤器搜索元广告库 — 端点功能

对象 描述
query 可选 Search keyword, brand name, or phrase to match in the Meta Ads Library (for example Shopify or running shoes).
country 可选 Two-letter ISO country code (such as US, DE, GB, FR, CA, AU) or ALL for worldwide search.
active_status 可选 Ad delivery status filter: active, inactive, or all.
ad_type 可选 Ad category filter: all, political_and_issue_ads, housing_ads, employment_ads, or credit_ads.
media_type 可选 Creative media format filter: all, video, image, meme, or none.
platforms 可选 Optional comma-separated placements: facebook, instagram, messenger, audience_network, threads, whatsapp.
languages 可选 Optional comma-separated two-letter ISO language codes (such as en, de, es, fr).
search_type 可选 Keyword matching mode: keyword_unordered or keyword_exact_phrase.
sort_by 可选 Server-side sort order: relevancy or impressions (highest impressions first).
start_date_min 可选 Optional lower bound for ad delivery start date in YYYY-MM-DD format.
start_date_max 可选 Optional upper bound for ad delivery start date in YYYY-MM-DD format.
include_details 可选 Set to true to enrich ads with advertiser Instagram follower counts and EU or UK demographic reach.
cursor 可选 Opaque nextCursor token from a previous response to fetch the next page of ads.
page_size 可选 Number of ads to return per page (1 to 30, default 10).

剩余免费测试请求:3 / 3。


输入参数

query
country
active_status
ad_type
media_type
platforms
languages
search_type
sort_by
start_date_min
start_date_max
include_details
cursor
page_size
API 示例响应
JSON
{
    "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' 


    
请求
检索特定竞争品牌投放的活跃或历史Facebook和Instagram广告接受任何Facebook页面标识符数字页面ID或Instagram账号并自动解析规范广告主ID返回可播放的高清视频链接轮播卡片CTA漏斗活跃天数持久性欧盟和英国覆盖率和游标分页
Endpoint ID: 38710
GET https://zylalabs.com/api/14873/competitor+ad+spy+and+video+creatives+data+api/38710/get+competitor+ads+by+page+or+instagram+handle
输入参数

通过页面或 Instagram 账户获取竞争对手广告 — 端点功能

对象 描述
target 必需 Competitor Facebook page link, numeric page ID (such as 20409006880), or Instagram handle (such as @loungebyzalando).
country 可选 Two-letter ISO country code (such as US, DE, GB) or ALL for global ad footprint.
active_status 可选 Ad delivery status filter: active, inactive, or all.
ad_type 可选 Ad category filter: all, political_and_issue_ads, housing_ads, employment_ads, or credit_ads.
media_type 可选 Creative media format filter: all, video, image, meme, or none.
platforms 可选 Optional comma-separated placements: facebook, instagram, messenger, audience_network, threads, whatsapp.
languages 可选 Optional comma-separated two-letter ISO language codes (such as en, de, es).
sort_by 可选 Server-side sort order: relevancy or impressions.
start_date_min 可选 Optional lower bound for ad delivery start date in YYYY-MM-DD format.
start_date_max 可选 Optional upper bound for ad delivery start date in YYYY-MM-DD format.
include_details 可选 Set to true to enrich ads with advertiser Instagram follower counts and EU or UK demographic reach.
cursor 可选 Opaque nextCursor token from a previous response to fetch the next page.
page_size 可选 Number of ads to return per page (1 to 30, default 10).

剩余免费测试请求:3 / 3。


输入参数

target
country
active_status
ad_type
media_type
platforms
languages
sort_by
start_date_min
start_date_max
include_details
cursor
page_size
API 示例响应
JSON
{
    "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"
            }
        ]
    }
}
通过页面或 Instagram 账户获取竞争对手广告 — 代码片段

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' 


    
请求
获取单个Meta广告档案ID的完整创意和监管透明度细节,包括可播放的高清MP4视频、轮播卡片、未包装的目标链接、广告主Instagram粉丝、政治支出和印象区间,以及欧盟DSA和英国的总覆盖范围,并按国家按年龄按性别进行受众细分
Endpoint ID: 38711
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 必需 Numeric Meta Ad Archive ID (such as 1952066089105921) to inspect.
country 可选 Optional two-letter ISO country code context (such as DE, GB, US) or ALL.

剩余免费测试请求:3 / 3。


输入参数

ad_id
country
API 示例响应
JSON
{
    "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' 


    
请求
将任何竞争对手的Facebook页面链接、数字页面ID或Instagram用户名解析为其规范的Meta广告库数字页面ID、验证过的页面类别、页面点赞数、简介、链接的Instagram用户名、Instagram粉丝人数和政治支出验证状态
Endpoint ID: 38712
GET https://zylalabs.com/api/14873/competitor+ad+spy+and+video+creatives+data+api/38712/resolve+page+or+instagram+handle+to+advertiser
输入参数

解析页面或Instagram用户名到广告主 — 端点功能

对象 描述
target 必需 Competitor Instagram handle (such as @loungebyzalando), numeric page ID, or Facebook page link.

剩余免费测试请求:3 / 3。


输入参数

target
API 示例响应
JSON
{
    "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"
    }
}
解析页面或Instagram用户名到广告主 — 代码片段

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 端点。要使用 竞争对手广告间谍和视频创意数据 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

标头
标头 描述
授权 必需 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

起价
$10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

概览

在200个国家以JSON格式检索数字营销广告创意 MP4视频流 旋转卡片和广告商活动元数据

竞争对手广告间谍和视频创意数据 API FAQs

是的。与官方的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的广告平台提取数据 确保反映最新的信息

典型的用例包括竞争分析 市场研究 和广告效果跟踪 市场营销人员可以分析竞争对手策略 评估广告效果 并识别不同地区数字广告的趋势

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

相关 API