Company Ads
curl --request GET \
--url https://api.sociavault.com/v1/scrape/facebook-ad-library/company-ads \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.sociavault.com/v1/scrape/facebook-ad-library/company-ads"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.sociavault.com/v1/scrape/facebook-ad-library/company-ads', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sociavault.com/v1/scrape/facebook-ad-library/company-ads",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sociavault.com/v1/scrape/facebook-ad-library/company-ads"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sociavault.com/v1/scrape/facebook-ad-library/company-ads")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sociavault.com/v1/scrape/facebook-ad-library/company-ads")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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"
},
"credits_used": 1
}Facebook Ad Library
Company Ads
Get all the ads a company has running
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>'import requests
url = "https://api.sociavault.com/v1/scrape/facebook-ad-library/company-ads"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.sociavault.com/v1/scrape/facebook-ad-library/company-ads', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sociavault.com/v1/scrape/facebook-ad-library/company-ads",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sociavault.com/v1/scrape/facebook-ad-library/company-ads"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sociavault.com/v1/scrape/facebook-ad-library/company-ads")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sociavault.com/v1/scrape/facebook-ad-library/company-ads")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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"
},
"credits_used": 1
}💳 1 credit per request
Authorizations
Query Parameters
The companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName
Example:
"367152833370567"
The name of the company. Can either use this or pageId
Example:
"Lululemon"
This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.
Example:
"ALL"
Status of the ad. Defaults to ACTIVE.
Available options:
ALL, ACTIVE, INACTIVE Example:
"ACTIVE"
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 to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc
Example:
"EN"
Start date to search for. Format: YYYY-MM-DD
Example:
"2025-01-01"
End date to search for. Format: YYYY-MM-DD
Example:
"2025-12-31"
Cursor to paginate through results
Example:
"AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP"
Set to true for a trimmed down version of the response
Example:
false
Response
Successful response
Key Response Fields:
data.results[0].ad_archive_id: The actual ad ID (use this —ad_idis always null)data.results[0].is_active: Whether the ad is currently runningdata.results[0].page_id: Facebook page ID running the addata.results[0].page_name: Facebook page namedata.results[0].start_date_string: ISO timestamp of when the ad starteddata.results[0].end_date_string: ISO timestamp of when the ad ended or will enddata.results[0].publisher_platform: Platforms the ad runs ondata.results[0].snapshot.title: Ad headline/titledata.results[0].snapshot.body.text: Ad body copydata.results[0].snapshot.cta_text: Call-to-action button textdata.results[0].snapshot.cards[0].original_image_url: Ad creative image URLdata.searchResultsCount: Total number of ads found for this companydata.cursor: Pagination cursor — pass ascursorto get further results
⌘I