mikesol / countries

🌎 Public GraphQL API for information about countries

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

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

The above GraphQL query will produce the following JSON response:

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

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
• Seed

License

MIT