Skip to main content

List Ad Demand Modifiers

GET 

/api/advertising/ad-plan/demand-modifiers

Lists the active ad-sourced demand modifiers that the demand forecast currently includes. Each modifier comes from an active Growth, Launch or Liquidate product goal (or an approved ramp on one) and adds uplift_per_day units per day to the product's forecast between start_date and end_date. Modifiers whose end_date has passed are omitted; the set is rebuilt nightly from the goals still open.

Required scope: advertising:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

meta.investment_needed is the total inventory investment the current ad plan ties up (incremental units over each product's lead time x landed unit cost), with the per-product breakdown in meta.products (each: product_id, sku, uplift_per_day, lead_time_days, landed_unit_cost, investment_needed, blocked). Not paginated.

Requires the advertising.view permission.

Available only when the tenant has both the advertising and advertising-manager features enabled; otherwise every route here returns 404.

Request​

Responses​

OK

Response Headers
    Content-Type