Forecast an audience
const url = 'https://ads.wortise.com/api/public/v1/inventory/forecast';const options = { method: 'POST', headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'}, body: '{"audience":{"app":{"category":[{"id":"example","label":"example"}],"list":[{"icon":"example","id":"example","label":"example","platform":"android"}]},"appFilters":{"coppa":true,"maxInstalls":1,"minInstalls":1,"minScore":1,"platform":["android"]},"cpm":1,"device":{"battery":{"plugged":true},"brand":["example"],"language":["example"],"model":["example"],"os":["android","ios"],"osVersion":["example"],"type":["mobile"]},"location":[{"countryCode":"example","displayName":"example","lat":1,"lng":1,"placeId":"example","source":"google_places","type":"place","types":["example"]}],"user":{"gender":["female"],"id":["example"],"age":["-18"],"interest":[{"id":"example","label":"example"}]}},"cost":1,"not":{"app":{"category":[{"id":"example","label":"example"}],"list":[{"icon":"example","id":"example","label":"example","platform":"android"}]},"appFilters":{"coppa":true,"maxInstalls":1,"minInstalls":1,"minScore":1,"platform":["android"]},"cpm":1,"device":{"battery":{"plugged":true},"brand":["example"],"language":["example"],"model":["example"],"os":["android","ios"],"osVersion":["example"],"type":["mobile"]},"location":[{"countryCode":"example","displayName":"example","lat":1,"lng":1,"placeId":"example","source":"google_places","type":"place","types":["example"]}],"user":{"gender":["female"],"id":["example"],"age":["-18"],"interest":[{"id":"example","label":"example"}]}},"size":["300x50"],"slices":25,"withApps":true}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://ads.wortise.com/api/public/v1/inventory/forecast \ --header 'Content-Type: application/json' \ --header 'x-api-key: <x-api-key>' \ --data '{ "audience": { "app": { "category": [ { "id": "example", "label": "example" } ], "list": [ { "icon": "example", "id": "example", "label": "example", "platform": "android" } ] }, "appFilters": { "coppa": true, "maxInstalls": 1, "minInstalls": 1, "minScore": 1, "platform": [ "android" ] }, "cpm": 1, "device": { "battery": { "plugged": true }, "brand": [ "example" ], "language": [ "example" ], "model": [ "example" ], "os": [ "android", "ios" ], "osVersion": [ "example" ], "type": [ "mobile" ] }, "location": [ { "countryCode": "example", "displayName": "example", "lat": 1, "lng": 1, "placeId": "example", "source": "google_places", "type": "place", "types": [ "example" ] } ], "user": { "gender": [ "female" ], "id": [ "example" ], "age": [ "-18" ], "interest": [ { "id": "example", "label": "example" } ] } }, "cost": 1, "not": { "app": { "category": [ { "id": "example", "label": "example" } ], "list": [ { "icon": "example", "id": "example", "label": "example", "platform": "android" } ] }, "appFilters": { "coppa": true, "maxInstalls": 1, "minInstalls": 1, "minScore": 1, "platform": [ "android" ] }, "cpm": 1, "device": { "battery": { "plugged": true }, "brand": [ "example" ], "language": [ "example" ], "model": [ "example" ], "os": [ "android", "ios" ], "osVersion": [ "example" ], "type": [ "mobile" ] }, "location": [ { "countryCode": "example", "displayName": "example", "lat": 1, "lng": 1, "placeId": "example", "source": "google_places", "type": "place", "types": [ "example" ] } ], "user": { "gender": [ "female" ], "id": [ "example" ], "age": [ "-18" ], "interest": [ { "id": "example", "label": "example" } ] } }, "size": [ "300x50" ], "slices": 25, "withApps": true }'Counts the inventory an audience reaches and the impressions available at a CPM, with breakdowns.
Requires the inventory:read scope.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”object
object
object
object
E.g: “1”, “20”.
object
object
object
object
Exact inventory locations or geographic areas to target.
object
object
Optional demographic filters. Age codes are ranges: -18=under 18, 18=18–24, 25=25–34, 35=35–44, 45=45–54, 55=55–64, 65=65+. Adults 18+ requires all six adult ranges, not just 18. Gender ?? means unknown, not all genders; omit gender on creation or use [] on update for unrestricted gender.
object
object
object
object
object
E.g: “1”, “20”.
object
object
object
object
Exact inventory locations or geographic areas to target.
object
object
Optional demographic filters. Age codes are ranges: -18=under 18, 18=18–24, 25=25–34, 35=35–44, 45=45–54, 55=55–64, 65=65+. Adults 18+ requires all six adult ranges, not just 18. Gender ?? means unknown, not all genders; omit gender on creation or use [] on update for unrestricted gender.
object
object
Responses
Section titled “Responses”Inventory lookup result.
object
object
object
object
Keyed by <platform>*<appId>, e.g. android*com.example; ?? is unknown
object
object
Cumulative impressions available up to each CPM price point of the sample
object
Share of total reached, 0-100
Requested CPM in USD, or the recommended one when no cost is sent
object
object
object
object
Impressions reachable at cpm
object
Keyed by ISO-2 country code; ?? is unknown
object
object
object
object
Impressions of the audience inventory
object
object
object
object
object
Example
{ "app": { "id": { "additionalProperty": { "platform": "android" } } }}The JSON body is malformed or fails the input validation.
object
Zod issues
object
Location of the invalid field in the procedure input
object
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "errors": [ { "code": "custom" } ], "message": "Validation Error"}The API key is missing, invalid, disabled or expired.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}The API key lacks the scope, or its owner lacks the dashboard permission.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}The API key exceeded its rate limit; retry after the Retry-After seconds.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}Headers
Section titled “Headers”Seconds to wait before retrying.
Unexpected server error.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}© 2026 Wortise. All rights reserved.