API Reference

Search brand library

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

Search Atria's global brand library by name. Results span all ingested sources (Meta and TikTok ad libraries), ordered by ad volume (ad_num) descending.

Each result's id carries an origin prefix: m* for Meta-origin brands and t* for TikTok-origin. Use that id directly when calling GET /open/v1/brand-library/{brand_id} or GET /open/v1/brand-library/{brand_id}/ads.

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

Brand name keyword. Case-insensitive substring match.

platform
array of objects

Restrict by source ad library. Repeatable. Allowed values: meta_ad_library, tiktok_ad_library — these match the ad_library field on each returned brand.

platform
Allowed:
industry
array of strings

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

Industry
integer
≥ 1
Defaults to 1

1-based page number (default 1).

integer
1 to 100
Defaults to 20

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

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