---
title: "Get library brand"
method: GET
path: "/open/v1/brand-library/{brand_id}"
tags: ["Brand Library"]
---

# Get library brand

`GET /open/v1/brand-library/{brand_id}`

Fetch full metadata for a single library brand: name, avatar, website, description, industries, ad count and source library.

Returns: `code=0` success; `code=40401` when no brand matches the id in the global catalog.

## Path parameters

- `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.

## Response `200`

Successful Response

- OpenLibraryBrandResponse — Envelope for all open API responses. code=0 means success.
  - `code` integer
  - `message` string
  - `data` OpenLibraryBrand — A brand from Atria's global ad-library catalog (Meta + TikTok). Distinct from `OpenOwnedBrand` (workspace-owned brand profile).
    - `id` string, required — Atria-prefixed stable brand identifier. Format `m*` (Meta) or `t*` (TikTok). Use this on brand-detail / brand-ads paths.
    - `name` string — Brand display name.
    - `avatar_url` string — Brand logo URL.
    - `website_url` string — Brand homepage URL if known.
    - `description` string — Brand mission / about-us blurb scraped from the platform.
    - `industries` string[] — Industry tags inferred from the brand's catalog presence.
    - `ad_num` integer — Approximate count of ads from this brand in Atria's library.
    - `source_library` string — Source library the brand was indexed from: `meta_ad_library` or `tiktok_ad_library`.
    - `status` string — Catalog ingestion state: `creating` (just registered), `scraping` (fetch in progress), `scraped` (data complete). Only `scraped` brands return useful detail / ad data.

## Other responses

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

---

[API](https://skmtc.net/tryatria/apis/atria-open-api.md) · [All operations](https://skmtc.net/tryatria/apis/atria-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryatria/atria-open-api/revisions/548d57b611ea/schema)