Skip to main content
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. 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:
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, 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 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. The exact ISO country codes in each group:
CA, MX, US
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
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
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
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
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.