> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apostra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Brand Studio

> See how an advertiser's brand shows up on AI surfaces such as Nara: its profile, where it is verified, and its organic and sponsored results.

> [!NOTE]
>
> Brand Studio is in beta. Your account needs the Brand Studio beta to see it.

Brand Studio is an advertiser's **Brand** section. It shows how the advertiser's
brand shows up where people ask AI about it: today that is Nara, where a brand
can have a Mini that answers when someone's own Mini asks. Open an advertiser
in the Apostra web app and choose **Brand**, or read the same facts through the
V3 API.

## What it shows

| Tab | What you see |
| - | - |
| Identity | The brand profile: logo, colours, voice, tagline, voice rules and disclaimers, the brand's AdCP registry record, and whether its `trust.json` grants its Mini. |
| Presence | Each surface and its state: whether Nara shows the brand's Mini as verified, and whether its pack is ready to export to ChatGPT. |
| Results | Organic results (talks, offers made and bought, fans, orders) and sponsored results (shown, chosen, talks started, orders), side by side and never added together. |
| Places | The advertiser's `store` catalog, which Nara answers "where's the nearest?" from, with coverage by city. |
| Creators | One report per creator deal, on TikTok or on Nara, with the post and its counts, and one per rep programme on Nara, with the links its rep handed out and the links opened. |
| Seasons | The Founding Brand offer and how seasons grow with the network. |
| Insights | Topics people asked about that the brand couldn't answer, and why they chose another option. |
| Trust | What left Nara about the brand each day: only its own rows of Nara's daily report. |

## What you will never see

Nara sends counts, amounts and dates only. You never see the words of any
talk, names, who asked, or which fans. **A count of talks, offers, fans or
sponsored results under 5 is withheld**, and Brand Studio shows it as "fewer
than 5", never as 0. A sponsored option's talks started and orders are also
withheld when they would reveal individual orders. Organic orders are the
exception: Nara lists them one by one, so they are counted exactly.

## Simulated and stand-in parts

While Brand Studio is in beta, some parts are labelled **Simulated** or
**Stand-in**:

* A fictional brand's results are simulated history. Nara never reports a
  brand on an `.example` domain, so Acme Outdoor and Fernhollow Audio always
  show simulated results.
* Places at national scale and "asked for the nearest" counts are simulated:
  Nara does not report them yet.
* Insights are simulated until Nara offers them.
* The Founding Brand offer is a stand-in until it is a product you can buy.

A part without a label is real.

## Who sees what

A brand is its own record in Apostra, outside any advertiser, so Coca-Cola is
one brand whether Coca-Cola, its agency or both run it. Who you are to a brand
decides what you see:

| You are | You see |
| - | - |
| Its owner: your organisation has proved the brand's domain, or its house's domain, on the organisation's Domains page | Everything, including its organic results |
| An operator its `brand.json` authorises: an `authorized_operators` entry names one of your organisation's proved domains, lists this brand or `*` in `brands`, and is inside its `valid_from` and `valid_until` dates | Everything, including its organic results, when the entry's `scopes` include `measurement` or `all` or name none, and it lists no `countries`. Otherwise, what anyone else sees |
| Anyone else | Its public identity and where it shows up |

Organic results are the brand's measurement, so an operator entry grants them
only when its `scopes` include `measurement` or `all`, or name no scopes,
which AdCP reads as broad authorisation. An entry scoped to other activities
alone, such as `rights_clearance`, reads the brand as anyone else does.

An `authorized_operators` entry grants access only when it matches AdCP's
`brand.json` schema exactly. An entry with no `brands`, a brand id, country
or scope the schema does not allow, or a date that is not an ISO 8601
timestamp such as `2026-01-01T00:00:00Z` grants nothing.

Organic results are not split by country yet, so an `authorized_operators`
entry limited to some `countries` does not grant them.

Paid results are different: they belong to the advertiser that paid. You always
see what your own buys did, and never another operator's spend on the same
brand.

## Reading it through the API

Brand Studio reads the V3 surface an agent reads. A brand's id is its domain,
or `domain/brand_id` when the domain's `brand.json` lists several brands. The
domain is lowercase and has no `www.`. You can pass it either way, for example
`www.Coca-Cola.com`, and the read answers with the brand's id, `coca-cola.com`.

Read the brand with `get`:

```json theme={null}
{ "kind": "brand", "id": "coca-cola.com", "include": ["presence", "surfaceResults"] }
```

* The brand itself carries its `name`, `url` and `logos` from its `brand.json`,
  its `house` when it belongs to one, and your `access`: `owner`, `operator` or
  `public`.
* `presence` returns `registry` (the brand's AdCP registry record), `trust`
  (its `trust.json` verdict) and `surfaces`: Nara's state (`verified`,
  `verified_demo`, `not_verified`, `simulated` or `not_present`) and whether
  the ChatGPT export is ready.
* `surfaceResults` returns the brand's organic results on each surface for the
  last 28 days, each count `null` when Nara withheld it, with a `provenance` of
  `live` or `simulated`. Only the owner and its authorised operators get it;
  anyone else finds it in `unavailableIncludes` with the reason.
* Nara reports by domain, so a brand within a domain, such as `pg.com/tide`,
  has no `presence` or `surfaceResults` of its own: both come back in
  `unavailableIncludes`. Read the domain's brand, `pg.com`, for them.

`search` with `kind: "brand"` lists the brands your advertisers name.

Read what an advertiser's own buys did with `get` on the advertiser and the
`paidResults` include:

```json theme={null}
{ "kind": "advertiser", "id": "17258", "include": ["brandProfile", "paidResults"] }
```

`paidResults` returns, per surface, its sponsored options, creator deals and
rep programmes (`reps`), with the same withheld counts and `provenance`. A rep
programme has a sponsored option's fields: `shown` is the links its rep handed
out and `chosen` the links opened. An advertiser's
`brandIdentity.brandRef` names its brand.

Places are the advertiser's catalogs of `type: "store"`, read with `search` and
`get` on `kind: "catalog"`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.