curl --request GET \
--url https://api.adspo.co/v1/creatives \
--header 'x-api-key: <api-key>'import requests
url = "https://api.adspo.co/v1/creatives"
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.adspo.co/v1/creatives', 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.adspo.co/v1/creatives",
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.adspo.co/v1/creatives"
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.adspo.co/v1/creatives")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.adspo.co/v1/creatives")
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{
"count": 1,
"next_cursor": null,
"creatives": [
{
"creative_id": "f930d886d0fb9e86b9dd6c1200dab7ef",
"brand_id": "857986847394146",
"brand_name": "DRMTLGY",
"format": "IMAGE",
"hd_url": "https://r2.adspo.co/creatives/images/original/f930d886d0fb9e86b9dd6c1200dab7ef.jpg",
"sd_url": "https://r2.adspo.co/creatives/images/resized/f930d886d0fb9e86b9dd6c1200dab7ef.jpg",
"is_active": false,
"start_date": "2026-03-16T07:00:00Z",
"end_date": "2026-04-24T07:00:00Z",
"runtime_days": 39,
"ad_count": 10,
"landing_pages": [
"https://www.example.com"
],
"countries": [
"AU",
"GB",
"NZ",
"US"
],
"languages": [
"en"
],
"impression_order": 11,
"variants": [],
"hook": null,
"visual_formats": [
"High Production",
"Demo"
]
}
]
}Get creatives
Returns a paginated list of creatives across the entire library, ordered by the specified sort. Each page holds up to 12 creatives.
Use q to search inside the creatives: their ad copy, video transcripts, on-screen text and landing page URLs. Results stay in order_by order.
Cursor-based pagination — pass next_cursor from the previous response as cursor, with the same order_by, q and filters. A cursor used with a different order_by returns 400.
Array filters (country, language) match creatives that include any of the provided values.
curl --request GET \
--url https://api.adspo.co/v1/creatives \
--header 'x-api-key: <api-key>'import requests
url = "https://api.adspo.co/v1/creatives"
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.adspo.co/v1/creatives', 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.adspo.co/v1/creatives",
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.adspo.co/v1/creatives"
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.adspo.co/v1/creatives")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.adspo.co/v1/creatives")
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{
"count": 1,
"next_cursor": null,
"creatives": [
{
"creative_id": "f930d886d0fb9e86b9dd6c1200dab7ef",
"brand_id": "857986847394146",
"brand_name": "DRMTLGY",
"format": "IMAGE",
"hd_url": "https://r2.adspo.co/creatives/images/original/f930d886d0fb9e86b9dd6c1200dab7ef.jpg",
"sd_url": "https://r2.adspo.co/creatives/images/resized/f930d886d0fb9e86b9dd6c1200dab7ef.jpg",
"is_active": false,
"start_date": "2026-03-16T07:00:00Z",
"end_date": "2026-04-24T07:00:00Z",
"runtime_days": 39,
"ad_count": 10,
"landing_pages": [
"https://www.example.com"
],
"countries": [
"AU",
"GB",
"NZ",
"US"
],
"languages": [
"en"
],
"impression_order": 11,
"variants": [],
"hook": null,
"visual_formats": [
"High Production",
"Demo"
]
}
]
}cursor is another request.Authorizations
Your Adspo API key.
Query Parameters
Sort order for results.
latest, oldest, longest_running, most_ads Pagination cursor from a previous response.
Search inside the creatives for a word or phrase: their ad copy, video transcripts, on-screen text and landing page URLs. Matches the exact phrase.
Results keep order_by; they are not ranked by relevance. Works with every other filter.
Limit q to one kind of text. Leave out to search all of them.
copy, transcript, on_screen_text, landing_page Filter by brand category.
Fashion & Apparel, Beauty & Cosmetics, Self Care & Hygiene, Health & Wellness, Home & Living, Software & Tech, Food & Beverages, Pet Supplies, Active & Sports, Outdoors & Travel, Jewelry & Accessories, Games & Hobbies, Other Filter creatives first seen on or after this date.
Accepted formats: YYYY-MM-DD, YYYY-MM-DD HH:MM:SS, YYYY-MM-DDTHH:MM:SS.
A bare date (e.g. 2024-11-12) is interpreted as 2024-11-12 00:00:00. Times without an offset are UTC.
Filter creatives first seen on or before this date. With start_date, this is the window the creatives started running in.
Accepted formats: YYYY-MM-DD, YYYY-MM-DD HH:MM:SS, YYYY-MM-DDTHH:MM:SS.
A bare date (e.g. 2024-11-12) includes the whole day. Times without an offset are UTC.
To find creatives that have stopped running, use is_active=false.
Filter by whether the creative is currently running.
Filter by creative format.
IMAGE, VIDEO Only creatives in this visual style, tagged from the image or video, the same list as the app's Visual format filter. Matched ignoring case. Each creative's visual_formats lists its own.
Animation, Before & After, Challenge / Experiment, Cinematic B-Roll, Customer Testimonial, Demo, Employee / BTS, Expert / Authority, Explainer, Flatlay, Founder Story, GIF / Static To Video, High Production, Illustration, Interview, Lifestyle, Listicle / Tier List, Low Stock / Back in Stock, Meme, Model / Try-on, Native, Offer / Discount, Organic, POV, Podcast, Product Features & Benefits, Product Shot, Reaction / Taste Test, Retail Announcement, Review / Social Proof, Screenshot / Mockup, Skit, Talking Head, Text-Heavy, Unboxing, Us vs Them, Yapper Minimum runtime in days.
Maximum runtime in days.
Minimum number of ad variants using this creative.
Maximum number of ad variants using this creative.
Minimum impression order rank. Lower values indicate higher estimated impressions.
Maximum impression order rank.
Comma-separated or repeated. Matches creatives shown in any of these countries.
Comma-separated or repeated. Matches creatives in any of these languages.
Returns an ads array containing all Meta ads running the creative, including details such as title, body_text, link_text, etc.
Response
A page of creatives.
Facebook Ad Library page ID. Only present on brand creatives responses.
The group's ID. Only present on group creatives responses.
Number of creatives returned in this page.
Pass this value as cursor to retrieve the next page. null when there are no more results.
Show child attributes
Show child attributes