Retrieve Text Ads

get

https://{APP_DOMAIN}/api/3.2/marketing/ads

Returns a paginated list of text ads embedded in newsletter emails. Includes related copywriter, publication, tags, effort, and category.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

integer

Filter by ad ID

active

boolean

Filter by active status

name

string

Filter by name

description

string

Filter by description

publication_id

integer

Filter by publication ID

user_id

integer

Filter by copywriter user ID

effort_id

integer

Filter by effort ID

ad_category_id

integer

Filter by ad category ID

num_sends

integer

Filter by number of sends. Supports operators: >, >=, <, <=

orders

integer

Filter by order count. Supports operators: >, >=, <, <=

revenue

number

Filter by revenue. Supports operators: >, >=, <, <=

last_sent_at

string

Filter by last sent date. Supports operators: >, >=, <, <=

created_at

string

Filter by creation date. Supports operators: >, >=, <, <=

updated_at

string

Filter by last updated date. Supports operators: >, >=, <, <=

tag_id

integer

Filter by tag ID (relationship filter)

id_with_name

string

Search by ID or name (partial match on both)

campaign_id

integer

Filter by campaign ID (matches via effort)

columns[]

integer

The field to be included in the json response. You can have multiple columns[] query params included in the request URL.

page

integer

The page to return.

per_page

integer

The total results to return per page.

sort

string

The field to sort the request by. column_name|asc OR desc

Response

Language

Credentials

Bearer

JWT

URL

Loading…

Response

Choose an example:

application/json

200The retrieved text ads