Scheduling Concepts
A subscription runs on a data-release event: it fires automatically whenever Similarweb publishes fresh data for the dataset in your report. You don’t set a clock — you follow the data, so each run always picks up the newest available period.
Choose your event
Set schedule.event to the release cadence that matches your data. For web data the common events are:
window
Fires on each daily web data release. Pair with a daily report.
weekly
Fires on each weekly web data release. Pair with a weekly report.
snapshot
Fires on each monthly web data release. Pair with a monthly report.
Additional events:
window_platform
snapshot_platform
shopper_weekly
shopper_snapshot
apps_window
apps_weekly
apps_snapshot
conversion_analysis_snapshot
technographics_window
Valid events depend on your query.
The events available to a subscription are validated against the datasets and metrics in your report. Other datasets have their own release events. If you choose an event that doesn't fit your query, the API responds with the allowed set so you can pick a compatible one — Validate Subscription is the quickest way to check.
The $date template
The most common pattern is to put the $date template in your report’s dates. At run time, $date resolves to the latest available date for the dataset, so each run exports the newest data without you editing the payload.
"start_date": "$date",
"end_date": "$date"
When a query joins tables with different release cadences, use interval_offset on the lagging table so $date only resolves once that table’s data is guaranteed to be available.
Expiration & renewal
Every subscription has an expiration_date. It must be in the future and at most 13 months out; if you omit it, it defaults to 3 months from creation. After it passes, the subscription stops running and is cleaned up automatically.
Update vs. Renew.
Use Update Subscription to change the report payload, event, or notifications. To change the expiration date, use Renew Subscription — update cannot change it.
Versions
Each edit creates a new subscription version; the most recent 10 versions are retained, so a change is always traceable.
Need a fixed calendar schedule?
Subscriptions follow data releases rather than a fixed clock. If you need a specific calendar or time-based schedule, contact your Similarweb account manager.
On this page
- Scheduling Concepts