Skip to main content
POST
Reach estimate

Authorizations

Authorization
string
header
required

A personal API key (adside_pat_…) or a token from adside login. Either carries the permissions of the person it belongs to.

Path Parameters

workspaceId
string
required
Minimum string length: 1

Body

application/json
geolocation
string
required

Country or region id, e.g. US.

ad_account_id
string

Reddit ad account id (a2_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused.

duration_days
default:7
gender
enum<string>
Available options:
MALE,
FEMALE
min_age
integer
Required range: 13 <= x <= 65
max_age
integer
Required range: 13 <= x <= 65
targeting
object

When given, also returns audience size and delivery estimates for this targeting.

objective
enum<string>
default:CLICKS
Available options:
APP_INSTALLS,
CATALOG_SALES,
CLICKS,
CONVERSIONS,
IMPRESSIONS,
LEAD_GENERATION,
VIDEO_VIEWABLE_IMPRESSIONS
daily_budget
number

For the delivery estimate, in the account currency. Default 50.

bid_type
enum<string>
default:CPC
Available options:
CPC,
CPM,
CPV,
CPV6,
CPV15
bid
number

Bid in the account currency. Default 0.50.

Response

200 - application/json

Success