Lifecycle of one ad creative
The whole trail of a single creative on this domain: when it was first and last observed, how many days it spanned, whether it is still running, the longest gap inside its life, its day-by-day observations, and the models and prompts that rendered it. Unbounded by any date range — the creative reports its real life. `globalFirstSeenAt`/`globalLastSeenAt` widen that to every organization that ever saw the same creative. Note that identity is a content fingerprint: rotating the copy, image or landing path mints a NEW creative, so this is the life of a creative variant, not of a campaign.
In: header
Path Parameters
Domain under analysis
Creative fingerprint from the creatives endpoint: 40 lower-case hex characters. Anything else is rejected with a 400 rather than queried.
Query Parameters
Days since the last observation within which the creative still counts as running. Measured from now, since this endpoint reports the creative's whole life rather than a window.
1 <= value <= 903How many prompts to return in the per-prompt breakdown
1 <= value <= 10020Response Body
application/json
curl -X GET "https://example.com/api/domains/3fa85f64-5717-4562-b3fc-2c963f66afa6/ads/creatives/9f2c1b7a4e6d3805c1aa27b4d9e0f3a6c85b1d47/lifecycle"{ "observedFirstSeenAt": "2026-04-18T06:02:00.000Z", "observedLastSeenAt": "2026-05-25T10:30:00.000Z", "lifespanDays": 37.19, "observedDays": 31, "observedAds": 412, "stillRunning": true, "globalFirstSeenAt": "2026-04-02T11:45:00.000Z", "globalLastSeenAt": "2026-05-25T10:30:00.000Z", "adKey": "9f2c1b7a4e6d3805c1aa27b4d9e0f3a6c85b1d47", "advertiserKey": "nike.com", "advertiserName": "Nike", "cardType": "product_ad", "format": "product_card_v2", "title": "Nike Pegasus 41", "body": "Responsive cushioning for daily miles.", "ctaProductCopy": "Shop now", "imageUrl": "https://nike.com/img/pegasus41.jpg", "targetUrl": "https://nike.com/t/pegasus-41", "longestGapDays": 6, "daily": [ { "date": "2026-05-25", "ads": 14, "executions": 12 } ], "byModel": [ { "key": "gpt-interface", "label": "best running shoes for flat feet", "ads": 96, "executions": 88 } ], "byPrompt": [ { "key": "gpt-interface", "label": "best running shoes for flat feet", "ads": 96, "executions": 88 } ]}