Skip to main content
POST
Promoted-posts 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
account_id
string

X ads account id (e.g. 18ce55xcrlv). Omit it: it defaults to the ads account this workspace is connected to, and any other account is refused.

line_item_id
string

Only promoted posts on this line item.

Pattern: ^[0-9a-z]{1,12}$
campaign_id
string

Only promoted posts in this campaign (its line items are looked up first).

Pattern: ^[0-9a-z]{1,12}$
approval_status
enum<string>

Filter on X's review outcome.

Available options:
ACCEPTED,
UNDER_REVIEW,
REJECTED
with_deleted
boolean
default:false
with_text
boolean
default:true

Look up each promoted post's tweet for text, media and card (one batched request per 200).

limit
integer
default:100

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

Required range: 1 <= x <= 1000

Response

200 - application/json

Success