curl, made-up values
curl 'https://api.poddata.ai/v1/ads/sig_01JD9F2D3E4F00000000000000' \
-H "Authorization: Bearer $PODDATA_API_KEY"import requests
url = "https://api.poddata.ai/v1/ads/{id}"
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/ads/{id}', 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/ads/{id}",
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/ads/{id}"
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/ads/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/ads/{id}")
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{
"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,
"company_name": "Northwind Dental",
"link": "cln_01JD8X4K2R5V00000000000000",
"page": "100000000000001",
"first_pull": {
"id": "sns_01JD0B1C2D3E00000000000000",
"day": "2026-11-04",
"captured_at": "2026-11-04T05:41:00.000Z",
"complete": true,
"items": 12
},
"last_pull": {
"id": "sns_01JD9F0A1B2C00000000000000",
"day": "2026-11-11",
"captured_at": "2026-11-11T05:40:00.000Z",
"complete": true,
"items": 14
},
"next_pull": null,
"link_out": null,
"same_words": 2
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}Ads and site
One ad: its words, where it runs, its start day, where it stands now and the pulls it was seen in
One ad, as GET /companies/{id}/ads lists it, with where it stands now: the pull it was first and last seen in, the one it was missing from, the brand’s page that runs it, and how many of that page’s other ads in its latest pull have the same words, since a brand often runs one message as many ads.
Before: Its id, from a brand’s ads or a number tool’s evidence.
Next: Its page in the library (url) shows it as Meta does, picture and all.
Limits: One a call. An ad of a company your team can’t see is a 404. link_out, where the ad points, is null for now.
GET
/
ads
/
{id}
curl, made-up values
curl 'https://api.poddata.ai/v1/ads/sig_01JD9F2D3E4F00000000000000' \
-H "Authorization: Bearer $PODDATA_API_KEY"import requests
url = "https://api.poddata.ai/v1/ads/{id}"
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/ads/{id}', 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/ads/{id}",
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/ads/{id}"
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/ads/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/ads/{id}")
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{
"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,
"company_name": "Northwind Dental",
"link": "cln_01JD8X4K2R5V00000000000000",
"page": "100000000000001",
"first_pull": {
"id": "sns_01JD0B1C2D3E00000000000000",
"day": "2026-11-04",
"captured_at": "2026-11-04T05:41:00.000Z",
"complete": true,
"items": 12
},
"last_pull": {
"id": "sns_01JD9F0A1B2C00000000000000",
"day": "2026-11-11",
"captured_at": "2026-11-11T05:40:00.000Z",
"complete": true,
"items": 14
},
"next_pull": null,
"link_out": null,
"same_words": 2
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}MCP tool:
get_ad, 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
Response
One ad