Countries GraphQL API

A public GraphQL API for information about countries, continents, and languages. This project uses Countries List and provinces as data sources, so the schema follows the shape of that data, with a few exceptions:

1. The codes used to key the objects in the original data are available as a code property on each item returned from the API.
2. The country.continent and country.languages are now objects and arrays of objects, respectively.
3. Each Country has an array of states populated by their states/provinces, if any.

• Writing queries
  • Migration notes (pre-March 2020)
• Docs
• Examples
• License

Writing queries

{
  country(code: BR) {
    name
    native
    emoji
    currency
    languages {
      code
      name
    }
  }
}

The above GraphQL query will produce the following JSON response:

{
  "data": {
    "country": {
      "name": "Brazil",
      "native": "Brasil",
      "emoji": "🇧🇷",
      "currency": "BRL",
      "languages": [
        {
          "code": "pt",
          "name": "Portuguese"
        }
      ]
    }
  }
}

Migration notes (pre-March 2020)

In the first version of this API, code arguments were treated as Strings. Now, they are enums of valid options only. To migrate, simply remove the double quotes from your existing code arguments:

{
- country(code: "CA") {
+ country(code: CA) {
    name
    emoji
  }
}

Docs

Check out the playground to explore the schema and test out some queries.

Examples

• React
• React Native
• ReasonML
• Country quiz app (React, TypeScript)
• Python

License

MIT