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

# Seller markets

> Set the channels and countries your Seller Account sells in with save_seller, and how they decide your Listing and which buyer requests reach you.

Your markets are the channels and countries you sell in. They belong to your
Seller Account, not to the sales agent behind it: one agent can serve several
sellers in different markets, and an agent's declared coverage names its
primary markets, not the only ones.

Your markets do two things:

* **Your Listing.** Buyers see your channels and countries on your Apostra
  Listing.
* **Which requests reach you.** A buyer's `get_products` request or media buy
  that names channels or countries outside your markets does not reach your
  sources. A request that names neither reaches all of them. If you set no
  channels, requests in every channel reach you; if you set no countries,
  requests from every country do. Buyers then see "All channels" or
  "All countries" on your Listing.

## Requests outside your markets do not reach you

Your markets are a filter, not a ranking. If a buyer's request names countries
and none of them is one of yours, your sources never receive it. The buyer sees
no products from you, and nothing tells you it happened: no error and no failed
request. The same holds for channels: a request that names channels and none of
them is one of yours is not sent to you.

A request that names several countries or channels reaches you when at least one
of them is in your markets. A request that names none reaches you.

This matters when your audience lives in more countries than your publication
is based in. Take a Turkish news publisher whose readers include Turkish
speakers living in the Netherlands. If it saves only `TR`, a Dutch buyer who
targets `NL` is never sent to that publisher, even though the audience is
there. The publisher gets no signal that the request existed.

So set your markets to the countries your audience is in, not only the country
you are based in:

* Add each country where your readers, viewers or listeners live and where you
  want buyers to find you, such as `NL` in the example.
* Or accept every country with `"acceptsAllCountries": true` and let buyers
  narrow by country themselves. Buyers then see "All countries" on your
  Listing.

To limit one buyer to particular countries without narrowing your markets for
everyone, use [buyer instructions](https://docs.apostra.com/v3/seller-buyer-instructions.md).

The rule applies whatever connects your inventory: Google Ad Manager, a modular
source or your own sales agent. If you connect one of those and are not a
pass-through storefront, your readiness checklist shows an **Accepted markets**
check that repeats this for your saved list. The check does not block going
live. Apostra does not yet keep a per-seller record of
requests turned away by your markets, so the check cannot tell you how many were.

Some storefronts carry a country list from an earlier setup that the seller
never confirmed. Requests are still filtered by that list. Your checklist shows
it under **Accepted markets** and asks you to confirm it. To confirm or change
it, save your countries, or worldwide acceptance, in your Listing or with
`save_seller`, as described below.

## If your storefront passes requests to your own sales agent

A pass-through storefront sends buyer requests on to your own sales agent.
Until you confirm your markets, Apostra assumes them:

* Your markets are the channels and countries already saved on your
  storefront plus the primary channels and countries your connected sales
  agents declare. Buyers see them on your Listing, and your Listing shows
  them to you as assumed.
* If neither names any channel, you are treated as selling in every channel.
  If neither names any country, you are treated as selling in every country.
* Requests and media buys outside these markets do not reach your agent.

Confirm your markets so buyers see where you actually sell. Once you save them,
only the values you saved count; your agent's declarations no longer change
them.

## Confirm your markets

You can confirm your markets in your Listing or through the API.

**In your Public profile.** Open **What you do** and choose **Edit**. The channels and
countries start from your assumed markets; if no country is assumed,
**Everywhere** is selected. Change them if you need to, then choose **Save
profile**. Saving confirms them as your markets, so the Public profile asks for at
least one channel and either at least one country or **Everywhere**. Until you
save, the Public profile says your markets are assumed.

To add many countries at once, pick a **country group** in the country list,
such as EMEA. The Listing adds every country in the group, and you can remove
any you don't sell in before you save. Your markets always hold individual
countries; a group is only a quick way to choose them.

**Through the API.** Save your channels together with your countries, or with
worldwide acceptance, in one `save_seller` call. That save confirms them as
your markets:

```json theme={null}
{
  "channels": ["display", "olv"],
  "countries": ["US", "CA"]
}
```

To accept every country, send `"acceptsAllCountries": true` instead of
`countries`. You can send the same fields grouped under `listing`.

On a pass-through storefront, the save must include at least one channel and
either at least one country or `"acceptsAllCountries": true`. Otherwise it is
refused with [`VALIDATION_FAILED`](https://docs.apostra.com/v3/errors), and the `field` names what is
missing. A confirmation chooses both dimensions, so it never turns on values
you didn't choose. Save a new operator domain and your markets in separate
calls.

After you confirm:

* Your Listing shows the markets you saved, and reports them as set by you.
* Requests and media buys outside them no longer reach your agent.

To change your markets later, save them again the same way. To limit one
buyer's work to particular countries without changing your markets, use
[buyer instructions](https://docs.apostra.com/v3/seller-buyer-instructions.md) instead.

## Country groups

Each group adds these countries. The lists follow the UN's regions, so Russia
counts as Europe and is in EMEA, not APAC.

| Group | Countries |
| - | - |
| NAM | North America: the United States, Canada and Mexico |
| LATAM | Latin America: Mexico, Central and South America, and the Caribbean |
| EMEA | Europe, the Middle East (including the Caucasus) and Africa |
| EUROPE | Europe, including Russia and the United Kingdom |
| EU | The 27 member states of the European Union |
| APAC | Asia outside the Middle East, and Oceania |

The exact ISO country codes in each group:

> [accordion] NAM (3 countries)
>
> CA, MX, US

> [accordion] LATAM (52 countries)
>
> AG, AI, AR, AW, BB, BL, BO, BQ, BR, BS, BV, BZ, CL, CO, CR, CU, CW, DM, DO, EC, FK, GD, GF, GP, GS, GT, GY, HN, HT, JM, KN, KY, LC, MF, MQ, MS, MX, NI, PA, PE, PR, PY, SR, SV, SX, TC, TT, UY, VC, VE, VG, VI

> [accordion] EMEA (129 countries)
>
> AD, AE, AL, AM, AO, AT, AX, AZ, BA, BE, BF, BG, BH, BI, BJ, BW, BY, CD, CF, CG, CH, CI, CM, CV, CY, CZ, DE, DJ, DK, DZ, EE, EG, EH, ER, ES, ET, FI, FO, FR, GA, GB, GE, GG, GH, GI, GM, GN, GQ, GR, GW, HR, HU, IE, IL, IM, IQ, IR, IS, IT, JE, JO, KE, KM, KW, LB, LI, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MG, MK, ML, MR, MT, MU, MW, MZ, NA, NE, NG, NL, NO, OM, PL, PS, PT, QA, RE, RO, RS, RU, RW, SA, SC, SD, SE, SH, SI, SJ, SK, SL, SM, SN, SO, SS, ST, SY, SZ, TD, TF, TG, TN, TR, TZ, UA, UG, VA, YE, YT, ZA, ZM, ZW

> [accordion] EUROPE (52 countries)
>
> AD, AL, AT, AX, BA, BE, BG, BY, CH, CY, CZ, DE, DK, EE, ES, FI, FO, FR, GB, GG, GI, GR, HR, HU, IE, IM, IS, IT, JE, LI, LT, LU, LV, MC, MD, ME, MK, MT, NL, NO, PL, PT, RO, RS, RU, SE, SI, SJ, SK, SM, UA, VA

> [accordion] EU (27 countries)
>
> AT, BE, BG, CY, CZ, DE, DK, EE, ES, FI, FR, GR, HR, HU, IE, IT, LT, LU, LV, MT, NL, PL, PT, RO, SE, SI, SK

> [accordion] APAC (62 countries)
>
> AF, AS, AU, BD, BN, BT, CC, CK, CN, CX, FJ, FM, GU, HK, HM, ID, IN, IO, JP, KG, KH, KI, KP, KR, KZ, LA, LK, MH, MM, MN, MO, MP, MV, MY, NC, NF, NP, NR, NU, NZ, PF, PG, PH, PK, PN, PW, SB, SG, TH, TJ, TK, TL, TM, TO, TV, TW, UM, UZ, VN, VU, WF, WS

Through the API, `save_seller` takes individual ISO country codes, so send the
countries a group covers rather than the group's name. Worldwide is not a
group: send `"acceptsAllCountries": true`.

## Regions from the deprecated media kit

Your markets are your countries. If you had regions but no countries on
26 October 2026, your regions became your countries then, unless your sales
agent declares countries. Apostra does not store regions. Reading your
`listing` returns your countries in `profile.regions`: ISO country codes,
`WORLDWIDE` when you accept every country, or an empty list when you name none.
If you still send `regions` through the deprecated `save_media_kit`, Apostra
saves them as your countries: country groups become their countries,
`WORLDWIDE` accepts every country, and codes that are neither a country nor a
group are ignored. Countries you send in the same save take precedence, and
resending what a read returned changes nothing. Use `save_seller` instead.


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