Skip to main content
POST
Ads list

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.

campaign_id
string

Only ads in this campaign (server-side filter).

Pattern: ^\d{6,25}$
ad_group_id
string

Only ads in this ad group (server-side filter).

Pattern: ^\d{6,25}$
status
enum<string>

Filter on configured_status. ARCHIVED and DELETED objects are hidden unless asked for.

Available options:
ACTIVE,
PAUSED,
ARCHIVED,
DELETED
effective_status
enum<string>

Filter on Reddit's effective status (server-side).

Available options:
ACTIVE,
PAUSED,
PENDING_APPROVAL,
REJECTED,
AD_GROUP_PAUSED,
CAMPAIGN_PAUSED,
COMPLETED,
ARCHIVED,
DELETED
include_archived
boolean
default:false
with_creative
boolean
default:true

Resolve each ad's post to show creative type and headline (one extra request per distinct post, max 25).

limit
integer
default:100

Maximum rows to return (bounds the answer, not the scan).

Required range: 1 <= x <= 500

Response

200 - application/json

Success