Query

locationGroups

List the region groups (European Union, DACH, continents, UN regions, ...) a canonical location filter accepts as group, in catalogue order, each with the country names it matches. The list is the same for every workspace and is not paginated.

MCP: getLocationGroups

Arguments

This field takes no arguments.

Returns

Returns [LocationGroup!]!.

code String!: The value to pass as group in a LocationCanonicalInput entry.
countries [String!]!: The canonical country names the group matches, as stored in a creator's country canonical location. A group filter entry behaves exactly like one country entry per name listed here.
name String!: The English name of the group.

Open in explorer ↗

Values are sampled from a demo workspace — substitute your own token and workspace id.

List the region groups a canonical location filter accepts as `group`, with the countries each one matches.

query.graphql

query LocationGroupsDefault {
  locationGroups {
    code
    name
    countries
  }
}

Headers

Authorization: Bearer docs_demo_token_0000000000000000000000
WORKSPACE-ID: 6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a

Request · cURL

curl https://app.archive.com/api/v2 \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer docs_demo_token_0000000000000000000000' \
  -H 'WORKSPACE-ID: 6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a' \
  -d '{
  "query": "query LocationGroupsDefault {\n  locationGroups {\n    code\n    name\n    countries\n  }\n}"
}'

Request · Node.js

const response = await fetch("https://app.archive.com/api/v2", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer docs_demo_token_0000000000000000000000",
    "WORKSPACE-ID": "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a"
  },
  body: JSON.stringify({
    query: `query LocationGroupsDefault {
  locationGroups {
    code
    name
    countries
  }
}`
  })
})
console.log(JSON.stringify(await response.json(), null, 2))

Request · Ruby

require "json"
require "net/http"

query = <<~'GRAPHQL'
  query LocationGroupsDefault {
    locationGroups {
      code
      name
      countries
    }
  }
GRAPHQL

response = Net::HTTP.post(
  URI("https://app.archive.com/api/v2"),
  { query: query }.to_json,
  "Content-Type" => "application/json",
  "Authorization" => "Bearer docs_demo_token_0000000000000000000000",
  "WORKSPACE-ID" => "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a"
)
puts response.body

Request · Python

import json
import requests

query = """
query LocationGroupsDefault {
  locationGroups {
    code
    name
    countries
  }
}
"""

response = requests.post(
    "https://app.archive.com/api/v2",
    json={"query": query},
    headers={
        "Authorization": "Bearer docs_demo_token_0000000000000000000000",
        "WORKSPACE-ID": "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a",
    },
)
print(json.dumps(response.json(), indent=2))

200 OK 508 lines

{
  "data": {
    "locationGroups": [
      {
        "code": "european_union",
        "name": "European Union",
        "countries": [
          "Austria",
          "France",
          "Germany",
          "Italy",
          "Spain"
        ]
      },
      {
        "code": "eurozone",
        "name": "Eurozone",
        "countries": [
          "Austria",
          "France",
          "Germany",
          "Italy",
          "Spain"
        ]
      },
      {
        "code": "eea",
        "name": "European Economic Area",
        "countries": [
          "Austria",
          "France",
          "Germany",
          "Italy",
          "Spain"
        ]
      },
      {
        "code": "efta",
        "name": "European Free Trade Association",
        "countries": [
          "Switzerland"
        ]
      },
      {
        "code": "schengen",
        "name": "Schengen Area",
        "countries": [
          "Austria",
          "France",
          "Germany",
          "Italy",
          "Spain",
          "Switzerland"
        ]
      },
      {
        "code": "asean",
        "name": "Southeast Asia (ASEAN)",
        "countries": []
      },
      {
        "code": "gcc",
        "name": "GCC",
        "countries": []
      },
      {
        "code": "arab_league",
        "name": "Arab League",
        "countries": []
      },
      {
        "code": "african_union",
        "name": "African Union",
        "countries": []
      },
      {
        "code": "ecowas",
        "name": "ECOWAS",
        "countries": []
      },
      {
        "code": "sadc",
        "name": "SADC",
        "countries": []
      },
      {
        "code": "eac",
        "name": "East African Community",
        "countries": []
      },
      {
        "code": "mercosur",
        "name": "Mercosur",
        "countries": [
          "Brazil"
        ]
      },
      {
        "code": "andean_community",
        "name": "Andean Community",
        "countries": []
      },
      {
        "code": "caricom",
        "name": "CARICOM",
        "countries": []
      },
      {
        "code": "pacific_alliance",
        "name": "Pacific Alliance",
        "countries": [
          "Mexico"
        ]
      },
      {
        "code": "usmca",
        "name": "USMCA",
        "countries": [
          "Canada",
          "Mexico",
          "United States"
        ]
      },
      {
        "code": "cis",
        "name": "CIS",
        "countries": []
      },
      {
        "code": "apec",
        "name": "APEC",
        "countries": [
          "Canada",
          "Japan",
          "Mexico",
          "United States"
        ]
      },
      {
        "code": "oecd",
        "name": "OECD",
        "countries": [
          "Austria",
          "Canada",
          "Switzerland",
          "Germany",
          "Spain",
          "France",
          "United Kingdom",
          "Italy",
          "Japan",
          "Mexico",
          "United States"
        ]
      },
      {
        "code": "g7",
        "name": "G7",
        "countries": [
          "Canada",
          "Germany",
          "France",
          "United Kingdom",
          "Italy",
          "Japan",
          "United States"
        ]
      },
      {
        "code": "g20",
        "name": "G20",
        "countries": [
          "Brazil",
          "Canada",
          "Germany",
          "France",
          "United Kingdom",
          "Italy",
          "Japan",
          "Mexico",
          "United States"
        ]
      },
      {
        "code": "brics",
        "name": "BRICS",
        "countries": [
          "Brazil"
        ]
      },
      {
        "code": "commonwealth",
        "name": "Commonwealth of Nations",
        "countries": [
          "Canada",
          "United Kingdom"
        ]
      },
      {
        "code": "dach",
        "name": "DACH",
        "countries": [
          "Germany",
          "Austria",
          "Switzerland"
        ]
      },
      {
        "code": "nordics",
        "name": "Nordics",
        "countries": []
      },
      {
        "code": "benelux",
        "name": "Benelux",
        "countries": []
      },
      {
        "code": "baltics",
        "name": "Baltics",
        "countries": []
      },
      {
        "code": "uk_ireland",
        "name": "UK & Ireland",
        "countries": [
          "United Kingdom"
        ]
      },
      {
        "code": "anz",
        "name": "ANZ",
        "countries": []
      },
      {
        "code": "latam",
        "name": "LATAM",
        "countries": [
          "Brazil",
          "Mexico"
        ]
      },
      {
        "code": "apac",
        "name": "APAC",
        "countries": [
          "Japan"
        ]
      },
      {
        "code": "mena",
        "name": "MENA",
        "countries": []
      },
      {
        "code": "emea",
        "name": "EMEA",
        "countries": [
          "United Kingdom",
          "Spain",
          "Italy",
          "Austria",
          "Switzerland",
          "Germany",
          "France"
        ]
      },
      {
        "code": "cee",
        "name": "CEE",
        "countries": []
      },
      {
        "code": "continent_europe",
        "name": "Europe",
        "countries": [
          "Austria",
          "France",
          "Germany",
          "Italy",
          "Spain",
          "Switzerland",
          "United Kingdom"
        ]
      },
      {
        "code": "continent_asia",
        "name": "Asia",
        "countries": [
          "Japan"
        ]
      },
      {
        "code": "continent_africa",
        "name": "Africa",
        "countries": []
      },
      {
        "code": "continent_north_america",
        "name": "North America",
        "countries": [
          "Canada",
          "Mexico",
          "United States"
        ]
      },
      {
        "code": "continent_south_america",
        "name": "South America",
        "countries": [
          "Brazil"
        ]
      },
      {
        "code": "continent_oceania",
        "name": "Oceania",
        "countries": []
      },
      {
        "code": "continent_antarctica",
        "name": "Antarctica",
        "countries": []
      },
      {
        "code": "un_africa",
        "name": "Africa (UN region)",
        "countries": []
      },
      {
        "code": "un_northern_africa",
        "name": "Northern Africa",
        "countries": []
      },
      {
        "code": "un_sub_saharan_africa",
        "name": "Sub-Saharan Africa",
        "countries": []
      },
      {
        "code": "un_eastern_africa",
        "name": "Eastern Africa",
        "countries": []
      },
      {
        "code": "un_middle_africa",
        "name": "Middle Africa",
        "countries": []
      },
      {
        "code": "un_southern_africa",
        "name": "Southern Africa",
        "countries": []
      },
      {
        "code": "un_western_africa",
        "name": "Western Africa",
        "countries": []
      },
      {
        "code": "un_americas",
        "name": "Americas",
        "countries": [
          "Mexico",
          "Brazil",
          "Canada",
          "United States"
        ]
      },
      {
        "code": "un_latin_america_caribbean",
        "name": "Latin America and the Caribbean",
        "countries": [
          "Mexico",
          "Brazil"
        ]
      },
      {
        "code": "un_caribbean",
        "name": "Caribbean",
        "countries": []
      },
      {
        "code": "un_central_america",
        "name": "Central America",
        "countries": [
          "Mexico"
        ]
      },
      {
        "code": "un_south_america",
        "name": "South America (UN region)",
        "countries": [
          "Brazil"
        ]
      },
      {
        "code": "un_northern_america",
        "name": "Northern America",
        "countries": [
          "Canada",
          "United States"
        ]
      },
      {
        "code": "un_asia",
        "name": "Asia (UN region)",
        "countries": [
          "Japan"
        ]
      },
      {
        "code": "un_central_asia",
        "name": "Central Asia",
        "countries": []
      },
      {
        "code": "un_eastern_asia",
        "name": "Eastern Asia",
        "countries": [
          "Japan"
        ]
      },
      {
        "code": "un_south_eastern_asia",
        "name": "South-eastern Asia",
        "countries": []
      },
      {
        "code": "un_southern_asia",
        "name": "Southern Asia",
        "countries": []
      },
      {
        "code": "un_western_asia",
        "name": "Western Asia",
        "countries": []
      },
      {
        "code": "un_europe",
        "name": "Europe (UN region)",
        "countries": [
          "United Kingdom",
          "Spain",
          "Italy",
          "Austria",
          "Switzerland",
          "Germany",
          "France"
        ]
      },
      {
        "code": "un_eastern_europe",
        "name": "Eastern Europe",
        "countries": []
      },
      {
        "code": "un_northern_europe",
        "name": "Northern Europe",
        "countries": [
          "United Kingdom"
        ]
      },
      {
        "code": "un_southern_europe",
        "name": "Southern Europe",
        "countries": [
          "Spain",
          "Italy"
        ]
      },
      {
        "code": "un_western_europe",
        "name": "Western Europe",
        "countries": [
          "Austria",
          "Switzerland",
          "Germany",
          "France"
        ]
      },
      {
        "code": "un_oceania",
        "name": "Oceania (UN region)",
        "countries": []
      },
      {
        "code": "un_australia_new_zealand",
        "name": "Australia and New Zealand",
        "countries": []
      },
      {
        "code": "un_melanesia",
        "name": "Melanesia",
        "countries": []
      },
      {
        "code": "un_micronesia",
        "name": "Micronesia",
        "countries": []
      },
      {
        "code": "un_polynesia",
        "name": "Polynesia",
        "countries": []
      }
    ]
  }
}