Area values

The location.area filter of People search and Company search, and of their count endpoints, selects a whole zone in one value: a main region such as EMEA, a UN region or subregion, a market cluster such as DACH or the Nordics, or an institutional group such as the European Union. People search matches the person's country, Company search the country of the headquarters.

Pass one zone id or an array of ids from the tables below. A zone matches every person or company whose country is one of its member countries.

{
  "currentPositionTitle": "Head of Sales",
  "location": {
    "area": ["MC:DACH", "MC:NORD"],
    "countryCode": "NL"
  }
}

This request returns heads of sales in Germany, Austria, Switzerland, the five Nordic countries and the Netherlands.

How zones combine

• Zones add up. An array of zones is OR-matched, and the zones add up with countryCode and country: { "area": "MC:DACH", "countryCode": "FR" } covers Germany, Austria, Switzerland and France.
• region and city narrow the result: they are combined with the zones and countries with AND.
• Overlapping zones count each country once: ["IG:EU", "IG:EEA"] covers the 30 countries of the European Economic Area.
• There is no exclusion. A zone only adds countries: to leave a country out, list the countries you want in countryCode instead.
• area accepts at most 20 values, like every location sub-field.

Accepted values

• Only the full ids of the tables below are accepted, in any case: mc:dach is read as MC:DACH.
• An acronym or a name, such as "DACH" or "Europe", returns HTTP 422 with error.code INVALID_FILTER_VALUE and the closest ids in details.suggestions (["MC:DACH"] for "DACH"). The request costs 0 credits.
• MENAT, MENAP and SAARC are not zones of their own: rebuild them from a zone and a few countries. MENAT is MC:MENA with countryCode "TR", MENAP is MC:MENA with ["AF", "PK"], and SAARC is MC:INSC with "AF". Sending one of these names returns HTTP 422 with the zone in details.suggestions and the countries to add in details.countryCodes.
• Three UN ids cover exactly the same countries as a main region and return the same results: GR:AMR and MR:AMER, GSR:NOAM and MR:NAMER, GSR:LAC and MR:LATAM.
• Country codes are ISO 3166-1 alpha-2, plus XK for Kosovo.
• The available-fields endpoints of People search and Company search return the same catalogue as data: the ids in allowedValues of location.area, and each zone with its member countries in areaCatalog.
• The prompt endpoints (People search by prompt, Company search by prompt) turn a region named in the prompt, such as "in the Nordics" or "across EMEA", into its zone id.

All zones (62)

Main regions (5)

Geographic regions (5)

Geographic subregions (24)

Market clusters (19)

Institutional and economic groups (9)