API Reference

List saved library ads

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

List ads the calling workspace has saved from the global ad library. Each item carries the standard ad fields plus a saved_details block (saved_at, boards, tags).

Scoped to the workspace bound to your API key. Use the response cursor to paginate.

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

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
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).

Language
string

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

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:
boards
array of strings

Restrict to ads saved in the given board(s). Pass board_id values from GET /open/v1/boards. Repeatable.

Boards
tags
array of strings

Restrict to ads tagged with any of the given tag names.

Tags
string
enum
Defaults to saved_newest

Sort order. saved_newest/saved_oldest use save time; newest/oldest use the ad's start date; most_active is longest currently-running.

Allowed:
integer
1 to 50
Defaults to 20

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

string

Opaque pagination cursor from the previous response.

Responses

Updated about 2 months ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 months ago