curl 'https://api.poddata.ai/v1/companies/northwind-dental/numbers/ads?source=meta-ad-library&on=2026-11-16&vs=2026-10-19' \
-H "Authorization: Bearer $PODDATA_API_KEY"import requests
url = "https://api.poddata.ai/v1/companies/{id}/numbers/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}/numbers/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}/numbers/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}/numbers/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}/numbers/ads")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/companies/{id}/numbers/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{
"numbers": "ads",
"company": {
"id": "northwind-dental",
"name": "Northwind Dental"
},
"params": {
"source": "meta-ad-library",
"on": "2026-11-16",
"vs": "2026-10-19"
},
"figures": [
{
"name": "running",
"label": "Ads running on Nov 16, 2026",
"value": 6,
"unit": "count",
"company": "northwind-dental",
"n": 6,
"small": false,
"interval": null
},
{
"name": "started",
"label": "Started since Oct 19, 2026",
"value": 3,
"unit": "count",
"company": "northwind-dental",
"n": 3,
"small": false,
"interval": null
}
],
"columns": [
{
"name": "running",
"label": "Running",
"unit": "count"
},
{
"name": "started",
"label": "Started",
"unit": "count"
}
],
"rows": [
{
"key": "northwind-dental",
"label": "Northwind Dental",
"kind": "company",
"company": "northwind-dental",
"values": {
"running": 6,
"started": 3
},
"small": false,
"day": "2026-11-16",
"source": null,
"category": null,
"url": null,
"was": null
},
{
"key": "harbor-smiles",
"label": "Harbor Smiles",
"kind": "company",
"company": "harbor-smiles",
"values": {
"running": null,
"started": null
},
"small": false,
"day": null,
"source": null,
"category": null,
"url": null,
"was": null
}
],
"evidence": {
"items": [
{
"kind": "signal",
"id": "sig_01EXAMPLE00000000000000001",
"source": "meta-ad-library",
"company": "northwind-dental",
"link": "cln_01EXAMPLE00000000000000001",
"day": "2026-10-02",
"url": "https://maps.example/reviews/1",
"row": "northwind-dental",
"rating": null,
"text": null
}
],
"total": 412,
"more": 411
},
"basis": {
"sources": [
{
"id": "meta-ad-library",
"name": "Meta's US ad library",
"network": "meta"
}
],
"independent": 1,
"window": {
"from": "2025-11-17",
"to": "2026-11-16"
},
"compare": null,
"method": "Made up for this example.",
"sample": {
"read": 412,
"of": 1180,
"from": "2023-02-01",
"to": "2026-11-16",
"days": 1385,
"undated": 0
},
"breaks": [],
"periods": null,
"left_out": [],
"caveats": []
},
"computed_at": "2026-11-17T14:00:00.000Z"
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}A brand's ads running on one day and on another, what started and stopped between them, by platform, for the target and each confirmed rival
A brand’s ads in Meta’s US library running on one day and on another, four weeks before if left out, what started and stopped between them, and the running ones by platform, for the company and each confirmed rival, by each brand’s last weekly pull on or before each day. A brand that can’t be counted is null, never 0. A row is a company. With format=csv its rows are a file under its columns, a number a cell, and with format=csv&part=figures its named figures are, a row each: counts and shares, never a review’s words. Its MCP tool answers the JSON only, since no tool hands over a file.
Before: The company is one of your team’s targets, or any company /companies/{id} takes. A review or record counts only where a link a person confirmed ties it (POST /companies/{id}/links/{link}/confirm), and a rival only once a person confirms it (POST /companies/{id}/rivals/{rival}/confirm). Ask for a read with POST /targets/{company}/read if coverage says a source hasn’t been read.
Next: Put it in a report as an exhibit, {"numbers": "ads", "company": "…", "params": {…}} with these arguments as its params, through PUT /diligence-reports/{id}/pages/{page}, and cite a figure in the page’s copy as {exhibit-id.figure_name}: the report fills it each time it’s read. Or save the rows with format=csv.
Limits: One api call, as JSON or as a file. At most 200 of the ids behind the figures are listed in evidence, and evidence.more says how many aren’t. Under 30 reviews a figure is small and comes with how many it rests on. part without format=csv is a 400.
curl 'https://api.poddata.ai/v1/companies/northwind-dental/numbers/ads?source=meta-ad-library&on=2026-11-16&vs=2026-10-19' \
-H "Authorization: Bearer $PODDATA_API_KEY"import requests
url = "https://api.poddata.ai/v1/companies/{id}/numbers/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}/numbers/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}/numbers/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}/numbers/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}/numbers/ads")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/companies/{id}/numbers/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{
"numbers": "ads",
"company": {
"id": "northwind-dental",
"name": "Northwind Dental"
},
"params": {
"source": "meta-ad-library",
"on": "2026-11-16",
"vs": "2026-10-19"
},
"figures": [
{
"name": "running",
"label": "Ads running on Nov 16, 2026",
"value": 6,
"unit": "count",
"company": "northwind-dental",
"n": 6,
"small": false,
"interval": null
},
{
"name": "started",
"label": "Started since Oct 19, 2026",
"value": 3,
"unit": "count",
"company": "northwind-dental",
"n": 3,
"small": false,
"interval": null
}
],
"columns": [
{
"name": "running",
"label": "Running",
"unit": "count"
},
{
"name": "started",
"label": "Started",
"unit": "count"
}
],
"rows": [
{
"key": "northwind-dental",
"label": "Northwind Dental",
"kind": "company",
"company": "northwind-dental",
"values": {
"running": 6,
"started": 3
},
"small": false,
"day": "2026-11-16",
"source": null,
"category": null,
"url": null,
"was": null
},
{
"key": "harbor-smiles",
"label": "Harbor Smiles",
"kind": "company",
"company": "harbor-smiles",
"values": {
"running": null,
"started": null
},
"small": false,
"day": null,
"source": null,
"category": null,
"url": null,
"was": null
}
],
"evidence": {
"items": [
{
"kind": "signal",
"id": "sig_01EXAMPLE00000000000000001",
"source": "meta-ad-library",
"company": "northwind-dental",
"link": "cln_01EXAMPLE00000000000000001",
"day": "2026-10-02",
"url": "https://maps.example/reviews/1",
"row": "northwind-dental",
"rating": null,
"text": null
}
],
"total": 412,
"more": 411
},
"basis": {
"sources": [
{
"id": "meta-ad-library",
"name": "Meta's US ad library",
"network": "meta"
}
],
"independent": 1,
"window": {
"from": "2025-11-17",
"to": "2026-11-16"
},
"compare": null,
"method": "Made up for this example.",
"sample": {
"read": 412,
"of": 1180,
"from": "2023-02-01",
"to": "2026-11-16",
"days": 1385,
"undated": 0
},
"breaks": [],
"periods": null,
"left_out": [],
"caveats": []
},
"computed_at": "2026-11-17T14:00:00.000Z"
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}numbers_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 row a company