ProvlyDocs

Search docs

Guides and API endpoints

DocsAPI referenceSystemData freshness

Data freshness

GET/api/v1/system/freshness

When the newest ad entered Provly and how many ads were discovered in the last 24 hours. Use it to decide whether to re-run a daily report.

Bearer API keyMCP tool get_freshness

Try it

GET/api/v1/system/freshness
curl "https://provly.co/api/v1/system/freshness" \
  -H "Authorization: Bearer $PROVLY_API_KEY"
200 · Response
{
  "data": {
    "latest_ad_discovered_at": "2026-09-26T08:21:00.000Z",
    "latest_ad_started_at": "2026-09-26T00:00:00.000Z",
    "ads_discovered_24h": 4210,
    "lag_minutes": 9,
    "generated_at": "2026-09-26T08:30:00.000Z"
  }
}