Skip to content
ShortVid API
All endpoints

Search Meta (Facebook & Instagram) Ad Library

GET/v1/facebook/ads/search2 Credits / ad (min 10 Credits)($0.20 / 1K ads)· Updated 2026-11-15

Direct Answer · Engineering Summary$0.20 / 1K ads (2 credits/ad) · 1.45 s live p50 (<10 ms cached) · No OAuth / Proxies

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

  • querystringrequired

    Brand, keyword, or advertiser search query (q, keyword, and advertiser are also accepted).

    Example: shopify

  • countrystring

    Two-letter ISO country code (US, GB, DE, CA, AU, etc.) or ALL.

    Example: US

  • active_statusstring

    Filter by ad status: active, inactive, or all.

    Example: active

  • limitinteger (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.

FieldTypeSample / Notes
codeintegerExample: 0
providerstringExample: https://shortvidapi.com
statusstringExample: ok
msgstringExample: success
dataobject
querystringExample: shopify
countrystringExample: US
active_statusstringExample: active
itemsarray of object
ad_archive_idstringExample: 952162490977746
collation_idstringExample: 983894761056945
collation_countintegerExample: 1
is_activebooleanExample: true
page_idstringExample: 20409006880
page_namestringExample: Shopify
page_profile_uristringExample: https://www.facebook.com/shopify/
page_profile_picture_urlstringExample: https://scontent-xxc1-1.xx.fbcdn.net/v/t39.35426-6/711695801
page_like_countintegerExample: 4556459
page_categoriesarray of object
ad_library_urlstringExample: https://www.facebook.com/ads/library/?id=952162490977746
start_dateintegerExample: 1793516400
start_date_isostringExample: 2026-11-01T07:00:00.000Z
end_dateintegerExample: 1794643200
end_date_isostringExample: 2026-11-14T08:00:00.000Z
publisher_platformarray of object
categoriesarray of object
currencystring
spendstring
reach_estimatestring
impressionsobject
impressions_textobject
impressions_indexobject
creativeobject
display_formatobject
titleobject
body_textobject
captionobject
link_urlobject
link_descriptionobject
cta_textobject
cta_typeobject
imagesobject
videosobject
cardsobject
countintegerExample: 20
total_countintegerExample: 14431
cursorstringExample: AQHTXmLqK1WBeRVjNJ1rX6aVixO-mvGlzo4LaVdDho77foAeiuW7CvTb0IxB
hasMorebooleanExample: 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-key header (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 use GET (not charged).
429
Rate limit exceeded (not charged). Respect the Retry-After header.
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.