Search ad library

get

https://api.tryatria.com/open/v1/ad-library/search

Search Atria's global ad library across all platforms. Returns a paginated list of ads matching the given filters, ordered by the chosen sort order.

Use the returned cursor value as the cursor query parameter on the next request to fetch the following page. A null cursor in the response means there are no more results.

Returns: code=0 success; code=40001 invalid query parameters.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

query

string

Free-text search against ad title, body and brand name.

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 code, e.g. en, zh).

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:

industry

array of strings

Filter by brand industry tag. Free-form tags from the brand's industries (e.g. apparel, sportswear, health/beauty, product/service).

Industry

video_length

array of objects

Filter video ads by duration buckets in seconds. Repeatable. Allowed buckets: 0-15, 15-30, 30-60, 60-120, 120- (60-plus seconds, open-ended).

video_length

Allowed:

order

string

enum

Defaults to newest

Sort order. newest is by ad start date (default), 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.