Skip to main content
POST
Bids suggest

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
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.

bid_type
enum<string>
default:CPC
Available options:
CPC,
CPM,
CPV,
CPV6,
CPV15
objective
enum<string>
default:CLICKS
Available options:
APP_INSTALLS,
CATALOG_SALES,
CLICKS,
CONVERSIONS,
IMPRESSIONS,
LEAD_GENERATION,
VIDEO_VIEWABLE_IMPRESSIONS
bid_strategy
enum<string>
default:MANUAL_BIDDING

Reddit refuses a suggestion without a delivery config (400 "Missing delivery config: bid_strategy", measured 2026-09-10). MANUAL_BIDDING is what a suggested bid is for.

Available options:
MANUAL_BIDDING,
MAXIMIZE_VOLUME,
TARGET_CPX
optimization_goal
string

e.g. CLICKS, PURCHASE, LEAD. Defaults from the objective (CLICKS → CLICKS, CONVERSIONS → PURCHASE, VIDEO_VIEWABLE_IMPRESSIONS → VIDEO_VIEW_6S, LEAD_GENERATION → LEAD, APP_INSTALLS → MOBILE_CONVERSION_INSTALL).

targeting
object

Reddit targeting object. Every key optional; omitted = no restriction.

daily_budget
number

Account currency.

Response

200 - application/json

Success