---
title: "List followed library brands"
method: GET
path: "/open/v1/brand-library/followed"
tags: ["Brand Library"]
---

# List followed library brands

`GET /open/v1/brand-library/followed`

List library brands the calling workspace is following / tracking. These are the catalog brands surfaced in the workspace's competitor view — same data pool as `GET /open/v1/brand-library/search`, filtered to the follow relation.

Scoped to the workspace bound to your API key.

Returns: `code=0` success; `code=40001` workspace context missing.

## Query parameters

- `page` integer — 1-based page number (default 1).
- `page_size` integer — Items per page (1-100, default 20).

## Response `200`

Successful Response

- OpenLibraryBrandListResponse — Envelope for all open API responses. code=0 means success.
  - `code` integer
  - `message` string
  - `data` OpenLibraryBrandListData — Page-based pagination wrapper (boards, brands).
    - `items` OpenLibraryBrand[]
      - `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.
    - `total` integer
    - `page` integer
    - `page_size` integer — Number of items actually returned on this page (== len(items)). On the last page or when the matching set is smaller than the requested page size, this is less than what the caller asked for.

## 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)