Run a pre-sales forecast

Executes a forecast using the specified targeting modules, time range, and line item type. Returns daily and weekly predicted impression values with confidence bounds. Rate limited to 10 requests per minute per account. Use GET /forecasting/keys and GET /forecasting/values to discover valid targeting options before calling this endpoint.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
date-time
required

The start time for the forecasting run.

date-time
required

The end time for the forecasting run.

non_targeting_keys
object
required
targeting_modules
object
required

Refer to the targeting guide for more information on constructing the modules object

Headers
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Responses
200

Forecast completed successfully. Result contains support_set_id, predicted_values_daily (array of daily intervals with prediction, upper_bound, and lower_bound), and predicted_values_weekly (aggregated).

400

Request validation failed. Possible causes: invalid targeting module, invalid line_item_type, start_time in the past, start_time after end_time, invalid deal IDs, or upstream forecast service error.

401

Authentication credentials are missing or invalid.

403

Permission denied.

429

Rate limit exceeded. Default limit is 10 requests per minute per account.

504

The upstream forecast service did not respond within 60 seconds. Please try again later.

Language
Credentials
:
URL
LoadingLoading…