{
"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'
After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the Political and Issue Ad Spend Transparency API simply include your bearer token in the Authorization header.
| Header | Description |
|---|---|
Authorization
|
Required
Should be Bearer access_key. See "Your API Access Key" above when you are subscribed.
|
No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.
Retrieve political, election, and public issue advertising spend brackets, impression ranges, funding entities, and regional delivery data.
Yes. Unlike the official Graph API ads_archive endpoint (which restricts commercial ads to the EU and UK), this API extracts active and inactive commercial ads across all 200+ countries including US, CA, AU, BR, SG, and ALL worldwide.
Yes. Video ads include direct CDN video streams in primaryVideoHdUrl, primaryVideoSdUrl, videoHdUrls, and videoPreviewImageUrl, while image and carousel ads include primaryImageUrl, imageUrls, and structured cards.
Pass the Instagram handle (such as @loungebyzalando), numeric page ID, or Facebook page link in the target parameter of Get Competitor Ads by Page or Instagram Handle. The API resolves the canonical numeric pageId automatically.
Ads delivered in European Union / EEA member states (under the Digital Services Act) and the United Kingdom (country=DE, FR, NL, ES, IT, GB, or UK) include euTotalReach, euAgeMin, euAgeMax, euGenderAudience, payer, beneficiary, and euReachBreakdown.
Meta publishes spend and impression ranges (spendLower, spendUpper, spendText, impressionsLower, impressionsUpper, currency, and byline) on regulated political and social-issue ads (set ad_type=political_and_issue_ads). For commercial US ads, use activeDays and collationCount.
When more ads are available upstream, the response includes hasNextPage=true and an encrypted nextCursor token (prefixed with ma1_). Pass cursor=ma1_... into your next request to retrieve subsequent pages with zero duplicate records.
Each endpoint returns detailed information about political and issue ads, including ad spend brackets, impression ranges, creative formats, advertiser details, and regional delivery data. For example, the "Get Competitor Ads" endpoint provides insights into ads run by specific brands, while "Get Single Ad Creative" offers transparency details for individual ads.
Key fields include adArchiveId, adUrl, activeStatus, startDate, endDate, totalCount, and items array containing ad details. For instance, the "Get Single Ad Creative" endpoint includes fields like euTotalReach, pageLikes, and audience demographics, providing comprehensive insights into each ad.
Parameters vary by endpoint but generally include filters like delivery status, ad type, media type, language, and date range. For example, the "Search Meta Ads Library" endpoint allows filtering by regulated category and creative format, enabling users to customize their search effectively.
The response data is structured in a JSON format, with a "meta" section providing request details and a "data" section containing the relevant ad information. Each ad's details are encapsulated in an "items" array, making it easy to iterate through multiple ads in a single response.
The data is sourced from the Facebook and Instagram Meta Ads Library, which aggregates advertising information from various campaigns across 200+ countries. This ensures a broad coverage of political and issue ads, maintaining relevance and accuracy in the data provided.
Typical use cases include competitive analysis, tracking political ad spending, understanding audience demographics, and evaluating ad performance. Marketers and researchers can leverage this data to inform strategies and assess the effectiveness of advertising campaigns.
Users can analyze the returned data to identify trends in ad spending, audience engagement, and creative effectiveness. For example, by examining the euTotalReach and demographics, users can tailor their campaigns to target specific audiences more effectively.
If the response indicates no results or partial data, users should check their query parameters for accuracy. Adjusting filters or expanding the date range can help retrieve more comprehensive results. The presence of hasNextPage can also guide users to explore additional data if available.
To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key to authenticate your requests.
You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.
The free trial lasts for 7 days and allows you to make up to 50 API requests.
No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.
Yes. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.
Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.
You can monitor your API usage through the response headers included with every request:
x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.
Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.
Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund