Graph Countries

About Graph Countries

Graph Countries is a GraphQL API for querying country-related data, based on the same dataset as restcountries.eu, offered free of charge and without usage restrictions. It exposes information including countries, timezones, currencies, languages, regions and subregions, top-level domains, calling codes, flags, bordering countries, and translations. It also supports computed queries such as shortest path between countries and distance to other countries, along with selection, pagination, filtering, searching, and ordering across entities.

The underlying data is scraped from restcountries.eu and stored in a Neo4j graph database, with the GraphQL schema inferred using the neo4j-graphql-js package and custom Cypher queries added for path and distance calculations. An Apollo server provides the GraphQL endpoint and an interactive playground for exploring queries.

The project can be used via its hosted endpoint or self-hosted by cloning the repository and connecting it to a Neo4j graph database with the APOC plugin installed, requiring Node.js and npm. It is intended for developers who need structured, queryable country data through a GraphQL interface, including graph-based relationships like bordering countries and route distances.

Key features

• GraphQL API for country-related data (timezones, currencies, languages, calling codes, flags, borders)
• Free to use without restrictions
• Supports select, paginate, filter, search and order on any entity
• Shortest path and distance queries between countries via custom Cypher queries
• Self-hostable with your own Neo4j graph database
• Includes GraphQL playground and GraphQL Voyager schema explorer

Frequently asked questions