Search Meta (Facebook & Instagram) Ad Library
GET/v1/facebook/ads/search2 Credits / ad (min 10 Credits)($0.20 / 1K ads)· Updated 2026-11-15
GET /v1/facebook/ads/search queries active or inactive commercial ads from the Meta (Facebook & Instagram) Ad Library by brand, keyword, or advertiser across any ISO country code without Meta identity verification, government ID upload, or Graph API token expiration. Each ad item includes ad_archive_id, page_id, page_name, publisher_platform, start_date_iso, ad_library_url, and structured creative copy, CTA buttons, destination link_url, images, videos, and DCO cards at $0.20 per 1,000 ads (2 credits/ad, 0 credits on empty results).
When to Use vs. Honest Limitations
- →Commercial & political Ad Library inventory: Reflects ads indexed in Meta's public Ad Library; spend/impression ranges are only populated by Meta on EU/UK transparency and political/issue ads.
- →1-hour Redis cache for fast competitive analysis: Identical keyword + country queries return in under 10 ms for 60 minutes; paid plans can append ?fresh=1 for live crawls.
- →Zero charge on 0-match brand queries: Queries for brands with zero active ads return HTTP 200 with items: [] and deduct 0 credits.
Search active or historical ads from the Meta Ad Library (data.items) by keyword, brand, or advertiser without Graph API identity verification or token expiration. Returns ad_archive_id, page_name, publisher_platform, start_date_iso, ad_library_url, and normalized creative (title, body_text, cta_text, link_url, images, videos, cards). Aliases: /v1/ads/meta-library, /v1/meta/ads/search, /v1/facebook/ads.
Query Parameters
querystringrequiredBrand, keyword, or advertiser search query (
q,keyword, andadvertiserare also accepted).Example:
shopifycountrystringTwo-letter ISO country code (
US,GB,DE,CA,AU, etc.) orALL.Example:
USactive_statusstringFilter by ad status:
active,inactive, orall.Example:
activelimitinteger (1 to 50)Number of ads to return (max 50).
Example:
20
Example Request (cURL / Python / JavaScript)
curl "https://api.shortvidapi.com/v1/facebook/ads/search?query=shopify" \
-H "x-api-key: tk_your_api_key"Live Response Preview
{
"code": 0,
"provider": "https://shortvidapi.com",
"status": "ok",
"msg": "success",
"data": {
"query": "shopify",
"country": "US",
"active_status": "active",
"items": [
{
"ad_archive_id": "952162490977746",
"collation_id": "983894761056945",
"collation_count": 1,
"is_active": true,
"page_id": "20409006880",
"page_name": "Shopify",
"page_profile_uri": "https://www.facebook.com/shopify/",
"page_profile_picture_url": "https://scontent-xxc1-1.xx.fbcdn.net/v/t39.35426-6/711695801_961364766710353_6794705337797030530_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=104&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=9-vHtp2yczgQ7kNvwGj3nsm&_...",
"page_like_count": 4556459,
"page_categories": [
"Software"
],
"ad_library_url": "https://www.facebook.com/ads/library/?id=952162490977746",
"start_date": 1793516400,
"start_date_iso": "2026-11-01T07:00:00.000Z",
"end_date": 1794643200,
"end_date_iso": "2026-11-14T08:00:00.000Z",
"publisher_platform": [
"FACEBOOK",
"INSTAGRAM"
],
"categories": [
"UNKNOWN"
],
"currency": null,
"spend": null,
"reach_estimate": null,
"impressions": {
"impressions_text": null,
"impressions_index": -1
},
"creative": {
"display_format": "DCO",
"title": "Imaginez votre boutique, Shopify la crée",
"body_text": "Vous avez quelque chose à vendre ? Créez une boutique en ligne en quelques secondes avec notre éditeur de boutique par IA.",
"caption": "shopify.com",
"link_url": "https://www.shopify.com/se/gratis-trial",
"link_description": "{{product.description}}",
"cta_text": "Sign up",
"cta_type": "SIGN_UP",
"images": [
"https://scontent-xxc1-1.xx.fbcdn.net/v/t39.35426-6/709365925_1384666760146875_2818162543480126316_n.jpg?_nc_cat=105&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=ddH0eyugeQsQ7kNvwGUNdoi&_nc_oc=Adq6DfeUNtTZXGfJ..."
],
"videos": [],
"cards": [
{
"title": "Imaginez votre boutique, Shopify la crée",
"body": "Vous avez quelque chose à vendre ? Créez une boutique en ligne en quelques secondes avec notre éditeur de boutique par IA.",
"link_url": "https://www.shopify.com/fr/essai-gratuit",
"link_description": "Créez une boutique gratuite",
"cta_text": "Sign Up",
"cta_type": "SIGN_UP",
"image_url": "https://scontent-xxc1-1.xx.fbcdn.net/v/t39.35426-6/709365925_1384666760146875_2818162543480126316_n.jpg?_nc_cat=105&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=ddH0eyugeQsQ7kNvwGUNdoi&_nc_oc=Adq6DfeUNtTZXGfJ...",
"video_hd_url": null,
"video_sd_url": null,
"video_preview_image_url": null
},
{
"title": "Nach der Beschreibung der Shop-Idee hilft dir Shopify bei dessen Gestaltung",
"body": "Hast du etwas zu verkaufen? Mit unserem KI-Shop-Builder kannst du in Sekundenschnelle einen Onlineshop erstellen.",
"link_url": "https://www.shopify.com/de/kostenloser-test",
"link_description": "Einen Shop gratis starten",
"cta_text": "Sign Up",
"cta_type": "SIGN_UP",
"image_url": "https://scontent-xxc1-1.xx.fbcdn.net/v/t39.35426-6/709365924_27536691172603919_6940813538727956875_n.jpg?_nc_cat=103&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=eAin9ZC4LH4Q7kNvwGxBln3&_nc_oc=Adp9JEKDc9UUmUw...",
"video_hd_url": null,
"video_sd_url": null,
"video_preview_image_url": null
}
]
}
},
{
"ad_archive_id": "1124861510230110",
"collation_id": "1397203762613423",
"collation_count": 4,
"is_active": true,
"page_id": "20409006880",
"page_name": "Shopify",
"page_profile_uri": "https://www.facebook.com/shopify/",
"page_profile_picture_url": "https://scontent-xxc1-1.xx.fbcdn.net/v/t39.35426-6/801938816_949535990838293_6401209138047491626_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=111&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=unD88DQ16hAQ7kNvwH4HwFV&_...",
"page_like_count": 4556459,
"page_categories": [
"Software"
],
"ad_library_url": "https://www.facebook.com/ads/library/?id=1124861510230110",
"start_date": 1790751600,
"start_date_iso": "2026-09-30T07:00:00.000Z",
"end_date": 1794643200,
"end_date_iso": "2026-11-14T08:00:00.000Z",
"publisher_platform": [
"FACEBOOK",
"INSTAGRAM"
],
"categories": [
"UNKNOWN"
],
"currency": null,
"spend": null,
"reach_estimate": null,
"impressions": {
"impressions_text": null,
"impressions_index": -1
},
"creative": {
"display_format": "DCO",
"title": "Faster checkout starts with Shopify POS",
"body_text": "At TALA Westfield, Shopify POS made the checkout experience faster, more intuitive and easier for the retail team.",
"caption": "shopify.com",
"link_url": "https://www.shopify.com/pos/pos-pro-yearly?page=paid",
"link_description": "Get in touch with Shopify",
"cta_text": "Learn more",
"cta_type": "LEARN_MORE",
"images": [],
"videos": [
{
"video_hd_url": "https://video-xxc1-1.xx.fbcdn.net/o1/v/t2/f2/m366/AQNtaDTfLBkSF6aQJjUumVMl9QWxANh--JlPvLkOI6lpnMSx0aIYBwHlkUIvePfIg6SGnyUyerw5iIEok_ZK6pbIZoYqQIxN4cXycE5VkcCQpg.mp4?_nc_cat=110&_nc_sid=b66105&_nc_ht=video-xxc1-1.xx.fbcdn...",
"video_sd_url": "https://video-xxc1-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQMz7BiKeVUnza_OiMvKrjbZFR8zcBr5aLk_MZwwxeWD64WM33W8dXpMhzQw_Urou4fWugkwjzkDqnkzrUi1MhTCYbN5Oyep38roFnoZXQ.mp4?_nc_cat=102&_nc_sid=ef5aa3&_nc_ht=video-xxc1-1.xx.fbcdn.net...",
"preview_image_url": "https://scontent-xxc1-1.xx.fbcdn.net/v/t39.35426-6/801963199_1730161944947903_3067863591162210785_n.jpg?_nc_cat=106&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=fIteMi6GAlgQ7kNvwFSxXRZ&_nc_oc=AdqRwsaWFd7RFK_I..."
}
],
"cards": [
{
"title": "Faster checkout starts with Shopify POS",
"body": null,
"link_url": "https://www.shopify.com/pos/pos-pro-yearly?page=paid",
"link_description": "Get in touch with Shopify",
"cta_text": "Learn More",
"cta_type": "LEARN_MORE",
"image_url": null,
"video_hd_url": "https://video-xxc1-1.xx.fbcdn.net/o1/v/t2/f2/m366/AQNtaDTfLBkSF6aQJjUumVMl9QWxANh--JlPvLkOI6lpnMSx0aIYBwHlkUIvePfIg6SGnyUyerw5iIEok_ZK6pbIZoYqQIxN4cXycE5VkcCQpg.mp4?_nc_cat=110&_nc_sid=b66105&_nc_ht=video-xxc1-1.xx.fbcdn...",
"video_sd_url": "https://video-xxc1-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQMz7BiKeVUnza_OiMvKrjbZFR8zcBr5aLk_MZwwxeWD64WM33W8dXpMhzQw_Urou4fWugkwjzkDqnkzrUi1MhTCYbN5Oyep38roFnoZXQ.mp4?_nc_cat=102&_nc_sid=ef5aa3&_nc_ht=video-xxc1-1.xx.fbcdn.net...",
"video_preview_image_url": "https://scontent-xxc1-1.xx.fbcdn.net/v/t39.35426-6/801963199_1730161944947903_3067863591162210785_n.jpg?_nc_cat=106&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=fIteMi6GAlgQ7kNvwFSxXRZ&_nc_oc=AdqRwsaWFd7RFK_I..."
},
{
"title": "Faster checkout starts with Shopify POS",
"body": null,
"link_url": "https://www.shopify.com/pos/pos-pro-yearly?page=paid",
"link_description": "Get in touch with Shopify",
"cta_text": "Learn More",
"cta_type": "LEARN_MORE",
"image_url": null,
"video_hd_url": "https://video-xxc1-1.xx.fbcdn.net/o1/v/t2/f2/m366/AQNtaDTfLBkSF6aQJjUumVMl9QWxANh--JlPvLkOI6lpnMSx0aIYBwHlkUIvePfIg6SGnyUyerw5iIEok_ZK6pbIZoYqQIxN4cXycE5VkcCQpg.mp4?_nc_cat=110&_nc_sid=b66105&_nc_ht=video-xxc1-1.xx.fbcdn...",
"video_sd_url": "https://video-xxc1-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQMz7BiKeVUnza_OiMvKrjbZFR8zcBr5aLk_MZwwxeWD64WM33W8dXpMhzQw_Urou4fWugkwjzkDqnkzrUi1MhTCYbN5Oyep38roFnoZXQ.mp4?_nc_cat=102&_nc_sid=ef5aa3&_nc_ht=video-xxc1-1.xx.fbcdn.net...",
"video_preview_image_url": "https://scontent-xxc1-1.xx.fbcdn.net/v/t39.35426-6/801963199_1730161944947903_3067863591162210785_n.jpg?_nc_cat=106&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=fIteMi6GAlgQ7kNvwFSxXRZ&_nc_oc=AdqRwsaWFd7RFK_I..."
}
]
}
}
],
"count": 20,
"total_count": 14431,
"cursor": "AQHTXmLqK1WBeRVjNJ1rX6aVixO-mvGlzo4LaVdDho77foAeiuW7CvTb0IxBA64F8Mcd",
"hasMore": true
}
}Response Fields
Success (code === 0). Charged according to the endpoint credit rate.
| Field | Type | Sample / Notes |
|---|---|---|
code | integer | Example: 0 |
provider | string | Example: https://shortvidapi.com |
status | string | Example: ok |
msg | string | Example: success |
data | object | |
query | string | Example: shopify |
country | string | Example: US |
active_status | string | Example: active |
items | array of object | |
ad_archive_id | string | Example: 952162490977746 |
collation_id | string | Example: 983894761056945 |
collation_count | integer | Example: 1 |
is_active | boolean | Example: true |
page_id | string | Example: 20409006880 |
page_name | string | Example: Shopify |
page_profile_uri | string | Example: https://www.facebook.com/shopify/ |
page_profile_picture_url | string | Example: https://scontent-xxc1-1.xx.fbcdn.net/v/t39.35426-6/711695801 |
page_like_count | integer | Example: 4556459 |
page_categories | array of object | |
ad_library_url | string | Example: https://www.facebook.com/ads/library/?id=952162490977746 |
start_date | integer | Example: 1793516400 |
start_date_iso | string | Example: 2026-11-01T07:00:00.000Z |
end_date | integer | Example: 1794643200 |
end_date_iso | string | Example: 2026-11-14T08:00:00.000Z |
publisher_platform | array of object | |
categories | array of object | |
currency | string | |
spend | string | |
reach_estimate | string | |
impressions | object | |
impressions_text | object | |
impressions_index | object | |
creative | object | |
display_format | object | |
title | object | |
body_text | object | |
caption | object | |
link_url | object | |
link_description | object | |
cta_text | object | |
cta_type | object | |
images | object | |
videos | object | |
cards | object | |
count | integer | Example: 20 |
total_count | integer | Example: 14431 |
cursor | string | Example: AQHTXmLqK1WBeRVjNJ1rX6aVixO-mvGlzo4LaVdDho77foAeiuW7CvTb0IxB |
hasMore | boolean | Example: true |
Status Codes
- 200
- Success (
code === 0). Charged according to the endpoint credit rate. - 400
- Invalid parameters, or API key placed in the URL query string (not charged).
- 401
- Missing or invalid
x-api-keyheader (not charged). - 402
- Insufficient credit balance (not charged).
- 403
- Account disabled (not charged).
- 404
- Unknown endpoint or disabled unstable endpoint (not charged).
- 405
- Method not allowed — all
/v1/*data endpoints useGET(not charged). - 429
- Rate limit exceeded (not charged). Respect the
Retry-Afterheader. - 503
- Temporary upstream or gateway error (not charged). Retry with exponential backoff.
Migrating from direct scraping and hitting HTTP 403 Forbidden or empty responses on www.tiktok.com? Read How to Fix TikTok HTTP Error 403 or compare quota limits in our TikTok API Quota & Cost Calculator.