List library brand ads

get

https://api.tryatria.com/open/v1/brand-library/{brand_id}/ads

List ads from Atria's global ad library that belong to a specific library brand. Filters here apply to that brand's ads only.

Returns: code=0 success; code=40401 when the brand does not exist in the global catalog.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

brand_id

string

required

Atria-prefixed library-brand identifier. Format m* (Meta-origin) or t* (TikTok-origin). Obtain it from GET /open/v1/brand-library/search or GET /open/v1/brand-library/followed (items[].id). Do not pass the raw platform page id.

Query Params

query

string

Free-text search inside this brand's ads.

platform

array of objects

Filter by ad platform. Repeatable. Allowed values: facebook, instagram, messenger, audience_network, threads, whatsapp, tiktok, linkedin.

platform

display_format

array of objects

Filter by display format. Repeatable. Allowed values: image, video, carousel, multi_images, multi_videos, dco, dpa.

display_format

Allowed:

language

array of strings

Filter by ad copy language (ISO 639-1).

Language

start_date

string

Inclusive lower bound on ad start date, format YYYY-MM-DD.

end_date

string

Inclusive upper bound on ad end date, format YYYY-MM-DD.

status

array of objects

Filter by ad status. Repeatable. Allowed values: active, inactive.

status

Allowed:

order

string

enum

Defaults to newest

Sort order. most_active is longest currently-running; best_match is relevance — only meaningful with query.

Allowed:

page_size

integer

1 to 50

Defaults to 20

Items per page (1-50, default 20).

cursor

string

Opaque pagination cursor from the previous response.

Responses

200Successful Response

400Invalid request — a query parameter, path parameter, or body field failed validation.