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

# Markets and audiences

> Choose where your buyers are and who you want to reach.

A [topic](https://docs.heralded.ai/concepts/strategy.md#topics) is one subject in one market for one audience. The same subject in another market or for another audience is a separate topic, with its own questions, score and history.

## Markets

Open **Markets and audiences** in your brand's settings. **Add a market** adds a country, **Global** or **Europe** to the choices for new topics. Adding a market uses no topics.

The **Home market** prefills new topics. Open another market's menu and choose **Make home market** to change it. Existing topics keep their market.

**Global** measures without a country. Its Google search volume comes from the United States. **Europe** measures ten countries as one topic market, even with a single question. The [Europe schedule](https://docs.heralded.ai/concepts/daily-updates-and-weekly-reports.md#europe-topics) describes its countries and languages.

## Language policy

Global and English-speaking markets use English. Other countries use their local languages and English. English accounts for a third of questions in the Netherlands, Denmark, Norway, Sweden, Finland, Romania, Belgium and Switzerland, and a quarter in other non-English markets. Europe applies each country's default.

Belgium splits local questions between Dutch and French. Switzerland splits them between German and French. An English question for a country names that country; a Global question names none. When a question moves to another market, a place that says where the asker is moves with it, while a destination the question is about, or a place whose products or rules it asks about, stays as written. Language markers beside measured questions identify the wordings you read.

The app API accepts `asked_in` as `local`, `english` or `both` when drafting or copying a topic. With `both`, `english_share` accepts `quarter`, `third` or `half`. Omitting these fields uses the market's defaults. English-speaking markets and Global use English only.

## Audiences

**All buyers** is the default audience for new topics. Choose **Add an audience** to save a name and **Who they are**, such as agencies running campaigns for several clients. Questions for that audience use the buyer's perspective.

Open an audience's menu and choose **Edit** to change its name or description. Renaming changes its label. Changing who they are affects questions drafted afterwards and leaves existing questions unchanged.

Adding an audience uses no topics. Only tracking a topic for that audience counts against your [workspace allowance](https://docs.heralded.ai/concepts/usage.md#topics-and-prompts).

## Remove a choice

**Remove** hides a market or audience from new topics. Existing topics, questions and history stay. A restored topic keeps its original market and audience, even if either was removed from these lists.

## Copy a topic

Open a topic's menu and choose **Copy to another market or audience**. Choose entries from your brand's lists, then select **Preview questions**. Check the questions and choose **Copy topic**. Each copy uses one topic from your workspace allowance.

A topic's market and audience stay fixed. Copy it to measure another combination. If Heralded cannot write every question for the destination audience, it tracks nothing and asks you to try again.

## Filter your results

Insight pages offer **Market** and **Audience** in **Filters** when there is more than one choice. Market selects topics for that market. Selecting Romania excludes Europe topics, including their Romanian answers. The language markers beside questions stay visible.

## Read the lists through the API

`GET /v1/brands/{brand_id}/markets` and MCP `get_markets` return `home_market`, the brand's `markets`, their `vocabulary` of names and `focus_options` for starring a market with its audience. `GET /v1/brands/{brand_id}/audiences` and MCP `get_audiences` return each audience's `id`, `name` and `description`. All buyers comes first, with a null ID.

Use `market` and `audience` in insight reads. In keyword and Search comparison reads, `country` selects the country of a Google check within those topics. Use `all_buyers` to select topics for All buyers; omit the audience to include every audience. [API keys](https://docs.heralded.ai/api-keys.md) and [assistant access](https://docs.heralded.ai/assistants.md) follow your access to the brand.

Topic references identify the topic in its market and audience. Question, question-fit and keyword writes use `tracked_topic_id` from that reference.


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