Skip to main content
GET
/
v1
/
scrape
/
facebook-ad-library
/
company-ads
Company Ads
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/facebook-ad-library/company-ads \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "success": true,
    "results": {
      "0": {
        "ad_archive_id": "1625888671364134",
        "collation_count": null,
        "collation_id": null,
        "page_id": "33693527731",
        "snapshot": {
          "branded_content": null,
          "page_id": "33693527731",
          "page_is_deleted": false,
          "page_profile_uri": "https://www.facebook.com/lululemon/",
          "root_reshared_post": null,
          "byline": null,
          "disclaimer_label": null,
          "page_name": "lululemon",
          "page_profile_picture_url": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.35426-6/502530959_572465035900069_8338653867845815259_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=8eLpmgUnaNEQ7kNvwEluO2L&_nc_oc=Adnjv01wRgHk1uSlv2pVMLDHwBUlH16_QX1ZCdQlDLxBiacYs14vA1TD3khvr9OE-40&_nc_zt=14&_nc_ht=scontent-ord5-2.xx&_nc_gid=S6raXC4R9RHcXhhl9Qx_jQ&oh=00_Afu5wvRY_0jt-hhOjpc98ewBQOXVQW9K5gYLPtrOV-Tpkg&oe=698F11E4",
          "event": null,
          "caption": "shop.lululemon.com",
          "cta_text": "Shop now",
          "cards": {
            "0": {
              "body": "Keep your practice going with stylish gear that performs. As always, just leave the shipping and returns to us.",
              "cta_type": "SHOP_NOW",
              "caption": "shop.lululemon.com",
              "link_description": "When feeling nothing is everything. The lululemon Align collection is so weightless and buttery soft, all you feel is your practice. Designed for Yoga. Intended to sit at bottom of calf. Hidden waistband pocket fits a card or key, and won't get in your way, This collection's great for low-impact workouts like yoga or whenever you want to feel really, really comfortable. Feels Buttery-Soft and Weightless, Nulu Fabric.",
              "link_url": "https://shop.lululemon.com/en-ca/p/women-crops/Align-Crop-21/_/prod8780230?color=31382&sz=2",
              "title": "lululemon Align™ High-Rise Crop 21\"",
              "cta_text": "Shop Now",
              "video_hd_url": null,
              "video_preview_image_url": null,
              "video_sd_url": null,
              "watermarked_video_hd_url": null,
              "watermarked_video_sd_url": null,
              "image_crops": {},
              "original_image_url": "https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/501040337_1833520400551502_7356299259003438152_n.jpg?_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=3ZZuIqcUwPoQ7kNvwFnHjX1&_nc_oc=AdmiZhypk6s1O3pLp8dY8fnw7VYP5etKO7_ymWvX7UbuSHhZNaVwie8QhulcRTIm2SE&_nc_zt=14&_nc_ht=scontent-ord5-3.xx&_nc_gid=S6raXC4R9RHcXhhl9Qx_jQ&oh=00_Afsn_Etxa6swvpuNypjDoUMNJTpo1g_34t8n7GedWwKzfQ&oe=698F04B3",
              "resized_image_url": "https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/501040337_1833520400551502_7356299259003438152_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=3ZZuIqcUwPoQ7kNvwFnHjX1&_nc_oc=AdmiZhypk6s1O3pLp8dY8fnw7VYP5etKO7_ymWvX7UbuSHhZNaVwie8QhulcRTIm2SE&_nc_zt=14&_nc_ht=scontent-ord5-3.xx&_nc_gid=S6raXC4R9RHcXhhl9Qx_jQ&oh=00_Afu5jPWXXo4PsJBPTTHNUB29i1VFDYWHv9G1b9i1sK0z1w&oe=698F04B3",
              "watermarked_resized_image_url": ""
            },
            "1": {
              "body": "Keep your practice going with stylish gear that performs. As always, just leave the shipping and returns to us.",
              "cta_type": "SHOP_NOW",
              "caption": "shop.lululemon.com",
              "link_description": "The five-pocket jean, reinvented. These classic-fit pants, powered by ABC technology, give you freedom of movement and all-day comfort. Designed for Casual. Streamlined fit that gives glutes and thighs breathing room:Our ABC (Anti-Ball-Crushing) technology uses an ergonomic gusset to remove tension from the crotch of our pants so you can move in comfort. Hidden zippered pocket, Flip up the cuffs to reveal reflective details. Everyday Performance, Warpstreme Fabric.",
              "link_url": "https://shop.lululemon.com/en-ca/p/men-pants/ABC-Pant-Classic-34/_/prod3470413?color=31382&sz=28",
              "title": "ABC Classic-Fit 5 Pocket Pants 34L Warpstreme",
              "cta_text": "Shop Now",
              "video_hd_url": null,
              "video_preview_image_url": null,
              "video_sd_url": null,
              "watermarked_video_hd_url": null,
              "watermarked_video_sd_url": null,
              "image_crops": {},
              "original_image_url": "https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/500990218_680996498019681_9199925266514752551_n.jpg?_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Qu4e3kQY6HAQ7kNvwEZ9czH&_nc_oc=AdnILQjowApJbxpNrCLM_44Qpoxasalnu4EgsP0YfQ4DvrBBhORGlSO3dOYWylgyKHQ&_nc_zt=14&_nc_ht=scontent-ord5-3.xx&_nc_gid=S6raXC4R9RHcXhhl9Qx_jQ&oh=00_AfsSY9ci--VfAu9X-KTZ6i3MD4uSCo2iAO2PdOaGlVg3IQ&oe=698EF2F9",
              "resized_image_url": "https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/500990218_680996498019681_9199925266514752551_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Qu4e3kQY6HAQ7kNvwEZ9czH&_nc_oc=AdnILQjowApJbxpNrCLM_44Qpoxasalnu4EgsP0YfQ4DvrBBhORGlSO3dOYWylgyKHQ&_nc_zt=14&_nc_ht=scontent-ord5-3.xx&_nc_gid=S6raXC4R9RHcXhhl9Qx_jQ&oh=00_Afs1mx9MEL8qjKLYE-gEPE_BcaAnzKxPx2s3f3VG9P2l8Q&oe=698EF2F9",
              "watermarked_resized_image_url": ""
            },
            "2": {
              "body": "Keep your practice going with stylish gear that performs. As always, just leave the shipping and returns to us.",
              "cta_type": "SHOP_NOW",
              "caption": "shop.lululemon.com",
              "link_description": "Train hard, not hot. Powered by Everlux, the Wunder Train collection is highly breathable and quickly wicks sweat so you feel less sweaty during (and after) your workout. Designed for Training. Waistband drawcord keeps your shorts in place so you don't have to pull them up, Hidden pocket in the waistband has space for your card and keys. Our Fastest-Drying, Everlux Fabric.",
              "link_url": "https://shop.lululemon.com/en-ca/p/women-shorts/Wunder-Train-HighRise-Short-4/_/prod10370400?color=0001&sz=14",
              "title": "Wunder Train High-Rise Shorts 4\"",
              "cta_text": "Shop Now",
              "video_hd_url": null,
              "video_preview_image_url": null,
              "video_sd_url": null,
              "watermarked_video_hd_url": null,
              "watermarked_video_sd_url": null,
              "image_crops": {},
              "original_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/501517343_669823675931691_8695646468465722968_n.jpg?_nc_cat=101&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=FoinsOoWE1EQ7kNvwG9Pkez&_nc_oc=Adl0788uQUyTuragCVl6-YY_j15t9Da8JN_KeT_YrQaLp88_r1Ul2lIvlp-fJkuu7yo&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=S6raXC4R9RHcXhhl9Qx_jQ&oh=00_AfsT27iKaq6NzY7Qmd4d7ooJhfA0zUdMQTsQb67QylBd4A&oe=698F0BD7",
              "resized_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/501517343_669823675931691_8695646468465722968_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=101&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=FoinsOoWE1EQ7kNvwG9Pkez&_nc_oc=Adl0788uQUyTuragCVl6-YY_j15t9Da8JN_KeT_YrQaLp88_r1Ul2lIvlp-fJkuu7yo&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=S6raXC4R9RHcXhhl9Qx_jQ&oh=00_Afsx9XN8axcnucwWoNk2QaNG-R9QQ3p3YoWBI7Ll1Z4_5A&oe=698F0BD7",
              "watermarked_resized_image_url": ""
            },
            "3": {
              "body": "Keep your practice going with stylish gear that performs. As always, just leave the shipping and returns to us.",
              "cta_type": "SHOP_NOW",
              "caption": "shop.lululemon.com",
              "link_description": "The five-pocket jean, reinvented. These classic-fit pants, powered by ABC technology, give you freedom of movement and all-day comfort. Designed for Casual. Streamlined fit that gives glutes and thighs breathing room:Our ABC (Anti-Ball-Crushing) technology uses an ergonomic gusset to remove tension from the crotch of our pants so you can move in comfort. Hidden zippered pocket, Flip up the cuffs to reveal reflective details. Everyday Performance, Warpstreme Fabric.",
              "link_url": "https://shop.lululemon.com/en-ca/p/men-pants/ABC-Pant-Classic-34/_/prod3470413?color=31382&sz=31",
              "title": "ABC Classic-Fit 5 Pocket Pants 34L Warpstreme",
              "cta_text": "Shop Now",
              "video_hd_url": null,
              "video_preview_image_url": null,
              "video_sd_url": null,
              "watermarked_video_hd_url": null,
              "watermarked_video_sd_url": null,
              "image_crops": {},
              "original_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/502544894_730202286103458_2281918677431026187_n.jpg?_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=b1PFHJ9FFYIQ7kNvwGuAJpa&_nc_oc=Adn89ijPQtv7rKSd2BoYBXWlhDskA5A6UAFBbBc0HNXaGnJ7btwTMCpsipoXPSD6lIE&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=S6raXC4R9RHcXhhl9Qx_jQ&oh=00_AfvjZ-v2ofJOrFv2fnkBpwIlXQeiDmJtaSFDR8KPOLgljw&oe=698EE3B2",
              "resized_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/502544894_730202286103458_2281918677431026187_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=b1PFHJ9FFYIQ7kNvwGuAJpa&_nc_oc=Adn89ijPQtv7rKSd2BoYBXWlhDskA5A6UAFBbBc0HNXaGnJ7btwTMCpsipoXPSD6lIE&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=S6raXC4R9RHcXhhl9Qx_jQ&oh=00_AfvMT5oO8EA3T7lRhSLiG6rHibSWJ4kQDR0Jc-DHp-JmYA&oe=698EE3B2",
              "watermarked_resized_image_url": ""
            },
            "4": {
              "body": "Keep your practice going with stylish gear that performs. As always, just leave the shipping and returns to us.",
              "cta_type": "SHOP_NOW",
              "caption": "shop.lululemon.com",
              "link_description": "The five-pocket jean, reinvented. These classic-fit pants, powered by ABC technology, give you freedom of movement and all-day comfort. Designed for Casual. Streamlined fit that gives glutes and thighs breathing room:Our ABC (Anti-Ball-Crushing) technology uses an ergonomic gusset to remove tension from the crotch of our pants so you can move in comfort. Hidden zippered pocket, Flip up the cuffs to reveal reflective details. Everyday Performance, Warpstreme Fabric.",
              "link_url": "https://shop.lululemon.com/en-ca/p/men-pants/ABC-Pant-Classic-32/_/prod8900334?color=31382&sz=32",
              "title": "ABC Classic-Fit 5 Pocket Pants 32L Warpstreme",
              "cta_text": "Shop Now",
              "video_hd_url": null,
              "video_preview_image_url": null,
              "video_sd_url": null,
              "watermarked_video_hd_url": null,
              "watermarked_video_sd_url": null,
              "image_crops": {},
              "original_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/501448825_2070138883495967_2405554454405002378_n.jpg?_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=-fWM3zmSTaUQ7kNvwGordqN&_nc_oc=AdnlPz6eNsYQyiRF6dHIWuHIsU9SNTuxVy-pczjUZlC_byBQ3LQn9uPU1jdbqZzzXEI&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=S6raXC4R9RHcXhhl9Qx_jQ&oh=00_AfvuItF5djH4mFLomy1h2X1X_fyuZOIl_84L5YlqMB_nUA&oe=698EF545",
              "resized_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/501448825_2070138883495967_2405554454405002378_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=-fWM3zmSTaUQ7kNvwGordqN&_nc_oc=AdnlPz6eNsYQyiRF6dHIWuHIsU9SNTuxVy-pczjUZlC_byBQ3LQn9uPU1jdbqZzzXEI&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=S6raXC4R9RHcXhhl9Qx_jQ&oh=00_AfsGy5USbY7NfgNQbIOcSDgiV2UJxOm3VuZKCXA9rI1kZw&oe=698EF545",
              "watermarked_resized_image_url": ""
            },
            "5": {
              "body": "Keep your practice going with stylish gear that performs. As always, just leave the shipping and returns to us.",
              "cta_type": "SHOP_NOW",
              "caption": "shop.lululemon.com",
              "link_description": "Warm up, train hard, cool down. These cropped joggers are designed to keep up with you. Too hot? No sweat, zips at the cuff let you de-layer fast. Designed for Running and Training. Classic fit is an easy fit that floats away from your body:Intended to sit below calf. Secure zippered pockets to store your phone and cards, Continuous drawcord is easy to cinch and won't get lost in the wash, Zippers at the cuff make them easy to get on and off quickly.",
              "link_url": "https://shop.lululemon.com/en-ca/p/womens-joggers/Adapted-State-Jogger-Crop/_/prod10642641?color=31382&sz=0",
              "title": "Adapted State High-Rise Cropped Joggers",
              "cta_text": "Shop Now",
              "video_hd_url": null,
              "video_preview_image_url": null,
              "video_sd_url": null,
              "watermarked_video_hd_url": null,
              "watermarked_video_sd_url": null,
              "image_crops": {},
              "original_image_url": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.35426-6/501016305_1332076267889462_2386317876659030056_n.jpg?_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=gLaPuaDNEu0Q7kNvwGiwaNh&_nc_oc=AdkkUmglwUjhHdLt4TfcHxeVw4rNhi3-zzVu_3sag60CM1KAi9DZzcD2vhxP1UppRcc&_nc_zt=14&_nc_ht=scontent-ord5-2.xx&_nc_gid=S6raXC4R9RHcXhhl9Qx_jQ&oh=00_Afu3WsuMDz0lBzRY4YJrXx-BWkCXDgrcJv4VmuF0QeIajw&oe=698EFDA1",
              "resized_image_url": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.35426-6/501016305_1332076267889462_2386317876659030056_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=gLaPuaDNEu0Q7kNvwGiwaNh&_nc_oc=AdkkUmglwUjhHdLt4TfcHxeVw4rNhi3-zzVu_3sag60CM1KAi9DZzcD2vhxP1UppRcc&_nc_zt=14&_nc_ht=scontent-ord5-2.xx&_nc_gid=S6raXC4R9RHcXhhl9Qx_jQ&oh=00_AfvPmuZ2cX4_3mw86N77e7CgYmhcH0hRCTU0LtRG86ELbg&oe=698EFDA1",
              "watermarked_resized_image_url": ""
            }
          },
          "body": {
            "text": "Keep your practice going with stylish gear that performs. As always, just leave the shipping and returns to us."
          },
          "cta_type": "SHOP_NOW",
          "display_format": "DPA",
          "link_description": "When feeling nothing is everything. The lululemon Align collection is so weightless and buttery soft, all you feel is your practice. Designed for Yoga. Intended to sit at bottom of calf. Hidden waistband pocket fits a card or key, and won't get in your way, This collection's great for low-impact workouts like yoga or whenever you want to feel really, really comfortable. Feels Buttery-Soft and Weightless, Nulu Fabric.",
          "link_url": "https://shop.lululemon.com/en-ca/c/whats-new/n1q0cf",
          "images": {},
          "page_categories": {
            "0": "Clothing (Brand)"
          },
          "page_like_count": 3444597,
          "title": "lululemon Align™ High-Rise Crop 21\"",
          "videos": {},
          "is_reshared": false,
          "extra_links": {},
          "extra_texts": {},
          "extra_images": {},
          "extra_videos": {},
          "country_iso_code": null,
          "brazil_tax_id": null,
          "additional_info": null,
          "ec_certificates": {}
        },
        "is_active": true,
        "has_user_reported": false,
        "report_count": null,
        "menu_items": {},
        "state_media_run_label": null,
        "page_is_deleted": false,
        "page_name": "lululemon",
        "impressions_with_index": {
          "impressions_text": null,
          "impressions_index": -1
        },
        "gated_type": "ELIGIBLE",
        "categories": {
          "0": "UNKNOWN"
        },
        "is_aaa_eligible": false,
        "contains_digital_created_media": false,
        "reach_estimate": null,
        "currency": "",
        "spend": null,
        "end_date": 1770537600,
        "publisher_platform": {
          "0": "FACEBOOK",
          "1": "INSTAGRAM",
          "2": "AUDIENCE_NETWORK",
          "3": "MESSENGER",
          "4": "THREADS"
        },
        "start_date": 1748847600,
        "contains_sensitive_content": false,
        "total_active_time": null,
        "regional_regulation_data": {
          "finserv": {
            "is_deemed_finserv": false,
            "is_limited_delivery": false
          },
          "tw_anti_scam": {
            "is_limited_delivery": false
          }
        },
        "hide_data_status": "NONE",
        "fev_info": null,
        "ad_id": null,
        "targeted_or_reached_countries": {},
        "url": "https://www.facebook.com/ads/library?id=1625888671364134",
        "start_date_string": "2025-06-02T07:00:00.000Z",
        "end_date_string": "2026-02-08T08:00:00.000Z"
      }
    },
    "searchResultsCount": 276,
    "cursor": "AQHSizCnSIXjFYiXwLW5i4s2c2ghheOh0b7lEmFfOsZZhQrNGRj4t4kKuTYMcZnV_bsO"
  },
  "creditsUsed": 1
}
💳 1 credit per request

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

​
pageId
string

The companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName

Example:

"367152833370567"

​
companyName
string

The name of the company. Can either use this or pageId

Example:

"Lululemon"

​
country
string

This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.

Example:

"ALL"

​
status
enum<string>

Status of the ad. Defaults to ACTIVE.

Available options:
ALL,
ACTIVE,
INACTIVE
Example:

"ACTIVE"

​
media_type
enum<string>

Media type of the ad. Defaults to ALL. Meme refers to ads with image and text. Not sure why they call it meme.

Available options:
ALL,
IMAGE,
VIDEO,
MEME,
IMAGE_AND_MEME,
NONE
Example:

"ALL"

​
language
string

Language to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc

Example:

"EN"

​
start_date
string

Start date to search for. Format: YYYY-MM-DD

Example:

"2025-01-01"

​
end_date
string

End date to search for. Format: YYYY-MM-DD

Example:

"2025-12-31"

​
cursor
string

Cursor to paginate through results

Example:

"AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP"

​
trim
boolean

Set to true for a trimmed down version of the response

Example:

false

Response

Successful response

Key Response Fields:

  • is_active: Whether the ad is currently running
  • ad_archive_id: The actual ad id