ads
GET /v1/ads/connections/{connection_id}/seasonal
The seasonal planner per country — demand by month, thresholds and dated proposals.
Authentication
Send an API key as a bearer token. The key must carry the ads.view permission; a key without it is refused with 403, not 404.
This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.
Try it
Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.
curl -X GET https://api.zinndigital.com/v1/ads/connections/{connection_id}/seasonal \
-H "Authorization: Bearer zdk_live_…"Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console
Details
Gated on ads.view. Read from our own rows (no network call): every country the account advertises in with its demand index by calendar month (100 = the country's average month) and its source — history (the account's own clicks by month and country), planner (Keyword Planner monthly search volumes, read on the house account where the history is thin) or none (no proposal is made from a guess). plans are the dated proposals ahead of a peak or quiet month: a budget change for the month (restored after ends_on) and, where the conversion rate moves and the campaigns use Smart Bidding, a Google Ads seasonality adjustment for the first days. Every write is an ads change that a person approves (/v1/ads/changes/{id}/approve). settings carries each threshold's value, Recommended default and bounds. Measured weekly by the daily audit (Temporal; docs/1006 §81).
Parameters
| Name | Type | Required | What it is |
|---|---|---|---|
connection_id (path) | string | Yes | — |
Response
| Name | Type | Required | What it is |
|---|---|---|---|
connection_id | string | Yes | — |
currency | string | Yes | ISO 4217 of the ad account |
measured_on | object | Yes | — |
settings | object[] | Yes | — |
countries | object[] | Yes | — |
plans | object[] | Yes | — |
Errors this endpoint can return
401 · 403 · 404 · 422 · 429