curl 'https://api.poddata.ai/v1/companies/northwind-dental/ads?on=2026-11-11&limit=1' \
-H "Authorization: Bearer $PODDATA_API_KEY"import requests
url = "https://api.poddata.ai/v1/companies/{id}/ads"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.poddata.ai/v1/companies/{id}/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.poddata.ai/v1/companies/{id}/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 => [
"Authorization: Bearer <token>"
],
]);
$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.poddata.ai/v1/companies/{id}/ads"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.poddata.ai/v1/companies/{id}/ads")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/companies/{id}/ads")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"company": {
"id": "northwind-dental",
"name": "Northwind Dental"
},
"source": "meta-ad-library",
"on": "2026-11-11",
"vs": "2026-10-14",
"pages": 1,
"pulls": [
{
"id": "sns_01JD9F0A1B2C00000000000000",
"day": "2026-11-11",
"captured_at": "2026-11-11T05:40:00.000Z",
"complete": true,
"items": 14
},
{
"id": "sns_01JCX1A2B3C400000000000000",
"day": "2026-10-14",
"captured_at": "2026-10-14T05:38:00.000Z",
"complete": true,
"items": 9
}
],
"on_pull": "2026-11-11",
"vs_pull": "2026-10-14",
"complete": true,
"counts": {
"running": 14,
"running_vs": 9,
"change": 5,
"started": 6,
"stopped": 1,
"not_seen": 0,
"platforms": {
"facebook": 14,
"instagram": 12
}
},
"cannot": null,
"data": [
{
"id": "sig_01JD9F2D3E4F00000000000000",
"source": "meta-ad-library",
"company": "northwind-dental",
"url": "https://www.facebook.com/ads/library/?id=990000000000001",
"library_id": "990000000000001",
"day": "2026-10-28",
"platforms": [
"facebook",
"instagram"
],
"words": "New patients: a cleaning, an exam and X-rays for $99 at any Northwind clinic. Book online in two minutes.",
"first_seen": "2026-11-04",
"last_seen": "2026-11-11",
"state": "running",
"started": true,
"gone_by": null
}
],
"next": "MjAyNi0xMC0yOA"
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}A brand's ads in an ad library: the days it has pulls, its counts on a day and an earlier one, and its ads, filtered by where they stand and by platform
A brand’s ads in Meta’s US ad library, from PodData’s weekly reads of its confirmed Facebook pages: every pull, newest first, so you can pick days; its counts on on and on vs; and its ads, newest start day first, each with its page in the library, Meta’s start day, where it runs, at most 80 of its words, the first and last pull it was seen in, and where it stands on on. state picks the ads running on on (the default), or those that started, stopped or weren’t seen since between vs and on, or all; platform narrows to one. Where it can’t count, cannot says why.
Before: The company has a confirmed facebook_page link, and PodData has read it at least once.
Next: GET /ads/{id} for one ad. For the brand beside its confirmed rivals, the number tools GET /companies/{id}/numbers/ads and GET /companies/{id}/numbers/ads-weeks.
Limits: 50 a page, or limit, at most 100, with next as the cursor. Stopped means missing from a pull that read the page to the end; missing from one that stopped short is not_seen, never stopped. A company your team can’t see is a 404.
curl 'https://api.poddata.ai/v1/companies/northwind-dental/ads?on=2026-11-11&limit=1' \
-H "Authorization: Bearer $PODDATA_API_KEY"import requests
url = "https://api.poddata.ai/v1/companies/{id}/ads"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.poddata.ai/v1/companies/{id}/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.poddata.ai/v1/companies/{id}/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 => [
"Authorization: Bearer <token>"
],
]);
$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.poddata.ai/v1/companies/{id}/ads"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.poddata.ai/v1/companies/{id}/ads")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/companies/{id}/ads")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"company": {
"id": "northwind-dental",
"name": "Northwind Dental"
},
"source": "meta-ad-library",
"on": "2026-11-11",
"vs": "2026-10-14",
"pages": 1,
"pulls": [
{
"id": "sns_01JD9F0A1B2C00000000000000",
"day": "2026-11-11",
"captured_at": "2026-11-11T05:40:00.000Z",
"complete": true,
"items": 14
},
{
"id": "sns_01JCX1A2B3C400000000000000",
"day": "2026-10-14",
"captured_at": "2026-10-14T05:38:00.000Z",
"complete": true,
"items": 9
}
],
"on_pull": "2026-11-11",
"vs_pull": "2026-10-14",
"complete": true,
"counts": {
"running": 14,
"running_vs": 9,
"change": 5,
"started": 6,
"stopped": 1,
"not_seen": 0,
"platforms": {
"facebook": 14,
"instagram": 12
}
},
"cannot": null,
"data": [
{
"id": "sig_01JD9F2D3E4F00000000000000",
"source": "meta-ad-library",
"company": "northwind-dental",
"url": "https://www.facebook.com/ads/library/?id=990000000000001",
"library_id": "990000000000001",
"day": "2026-10-28",
"platforms": [
"facebook",
"instagram"
],
"words": "New patients: a cleaning, an exam and X-rays for $99 at any Northwind clinic. Book online in two minutes.",
"first_seen": "2026-11-04",
"last_seen": "2026-11-11",
"state": "running",
"started": true,
"gone_by": null
}
],
"next": "MjAyNi0xMC0yOA"
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}company_ads, on PodData’s MCP server at https://api.poddata.ai/mcp, does what this route does, with the same key. See The MCP server.Authorizations
Query Parameters
Response
A brand's ads on a day