Ad API Guide

Evidence

Cohorts, runs and scripts

Nothing on this site is a number we were told. It is a call we made, with the response kept.

Cohort runs

RunCohortAdvertisersCallsValidEst. costRaw responses
2026-11-09v11010097$1.38One JSON file per call at /evidence/ads-runs/2026-11-09/<platform>-<provider>-<aNN>.json, e.g. meta-sc_company-a01.json; tables as CSV under /evidence/ads-runs/2026-11-09/tables/.
2026-11-02v11010098$1.58One JSON file per call at /evidence/ads-runs/2026-11-02/<platform>-<provider>-<aNN>.json, e.g. meta-sc_company-a01.json; tables as CSV under /evidence/ads-runs/2026-11-02/tables/.
2026-10-26v110100100$1.56One JSON file per call at /evidence/ads-runs/2026-10-26/<platform>-<provider>-<aNN>.json, e.g. meta-sc_company-a01.json; tables as CSV under /evidence/ads-runs/2026-10-26/tables/.
2026-10-19v110100100$1.58One JSON file per call at /evidence/ads-runs/2026-10-19/<platform>-<provider>-<aNN>.json, e.g. meta-sc_company-a01.json; tables as CSV under /evidence/ads-runs/2026-10-19/tables/.
2026-10-12v110100100$1.53One JSON file per call at /evidence/ads-runs/2026-10-12/<platform>-<provider>-<aNN>.json, e.g. meta-sc_company-a01.json; tables as CSV under /evidence/ads-runs/2026-10-12/tables/.
2026-10-05v11010070$1.58One JSON file per call at /evidence/ads-runs/2026-10-05/<platform>-<provider>-<aNN>.json, e.g. meta-sc_company-a01.json; tables as CSV under /evidence/ads-runs/2026-10-05/tables/.
2026-09-28v11010093$1.58One JSON file per call at /evidence/ads-runs/2026-09-28/<platform>-<provider>-<aNN>.json, e.g. meta-sc_company-a01.json; tables as CSV under /evidence/ads-runs/2026-09-28/tables/.
2026-09-21v110100100$1.58One JSON file per call at /evidence/ads-runs/2026-09-21/<platform>-<provider>-<aNN>.json, e.g. meta-sc_company-a01.json; tables as CSV under /evidence/ads-runs/2026-09-21/tables/.
2026-09-15v110100100$1.58One JSON file per call at /evidence/ads-runs/2026-09-15/<platform>-<provider>-<aNN>.json, e.g. meta-sc_company-a01.json; tables as CSV under /evidence/ads-runs/2026-09-15/tables/.

Re-run the cohort

treg auth login
scripts/run-ads-cohort.py evidence/fixtures/ads-cohort-v1.json evidence/ads-runs/$(date +%F)
scripts/score-ads-cohort.py evidence/fixtures/ads-cohort-v1.json evidence/ads-runs/$(date +%F)

Download cohort v1 · runner · scorer

What is in the raw files

Each file holds the provider's full response plus a run header (platform, provider, advertiser, wall-clock latency, timestamp, exit code). Ad-library records are public data published by the platforms about advertisers; creative URLs point at the platforms' own CDNs and may expire. No credentials and no personal data are present.