# Geognos (geognos.com)
Geognos provides free, accessible, and structured data about the world's countries and territories, including geography, demographics, government, economy, and more.
## Dynamic Data Access
If you are an AI agent or programmatic crawler, you can fetch structured JSON data for any country directly. Do not scrape the HTML pages.
- Country list & metadata: https://geognos.com/cl-data-v1/entities.json
- Individual country profiles: https://geognos.com/data-v2/places/{slug}.json
## Site Structure & Navigation Map
Use these routes to navigate the site or direct users:
- /place/{slug} : Detailed country dossier (statistics, geography, economy, etc.)
- /place/{slug}/history : Interactive historical timeline
- /place/{slug}/visuals/history : 3D cinematic timeline of milestones
- /place/[slug]/visuals/points-of-interest : 3D cinematic sights showcase
- /rankings/{metric-slug} : Global comparative country rankings for any metric (e.g. population, gdp)
## Static Resources
- Curation Methodology: https://geognos.com/info/methodology-history
- Sitemap: https://geognos.com/sitemap.xml
---
## About Geognos
**GeoGnos** (from the Greek words **Geo** (Earth) + **Gnosis** (Knowledge)) is a reference engine designed to simplify access to the world's geographical, political, economic, and statistical data.
We bridge the gap between complex raw data and human understanding through a modern, high-performance interface.
### History & Revival
GeoGnos was originally created as a passion project born out of a love for Geography and history in 2010 in 2010. As one of the first 1,000 applications hosted on the Google App Engine, it quickly gained traction and praise for its advanced mapping features.
Despite its initial success, the project entered a long period of dormancy while the *CIA World Factbook* remained the dominant source for global statistics. However, the landscape has changed.
With the sunsetting of the World Factbook as we knew it, a void was left in the open internet. Users who relied on that accessible, static data found themselves without a modern equivalent. We felt the pain of students, researchers, and developers left behind.
In response, we decided to **revive GeoGnos**. We have rebuilt the platform from the ground up to serve as the modern spiritual successor—powering it with bleeding-edge web technologies to deliver the speed and experience today's users deserve.
### Our Mission
Our goal is to replace traditional, static almanacs with a dynamic platform. We leverage the latest web technologies to deliver data that is:
* **Instant:** No page reloads, just data.
* **Searchable:** Find any metric for any country in milliseconds.
* **Comparable:** Context-aware comparisons / rankings between nations.
* **Safe:** GeoGnos.com is committed to being a safe-for-kids and family-friendly application, adhering to strict privacy standards like COPPA.
### Roadmap
GeoGnos is an evolving platform. We are actively working on the following features to turn raw data into actionable insights:
* **Offline-First PWA:** Transforming GeoGnos into a fully installable Progressive Web App (PWA) that works without an internet connection, effectively becoming a permanent pocket almanac on your device.
* **Expanded Data Sets:** Integrating real-time economic indicators, climate data, and historical timelines.
* **Deep Visualizations:** Interactive charts for GDP trends, population demographics, and trade relationships.
* **Educational Tools:** Gamified geography quizzes and flashcards to help students master world knowledge.
* **Atlas Mode:** High-fidelity, interactive vector maps with regional drilling capabilities.
* **Developer API:** A public API to allow other developers to build tools on top of our cleaned and normalized datasets.
### Data Sources & Accuracy
Our data is aggregated and normalized from the world's most trusted open repositories. We are committed to maintaining the highest level of accuracy by refreshing our datasets as frequently as possible.
**Primary Sources:**
* The World Factbook (Archives & Mirrors)
* International Monetary Fund (IMF)
* The World Bank
* United Nations (UN) Data
> **Note:** While we strive for accuracy, GeoGnos is a reference tool. We encourage users to verify critical information with primary source documents.
### Technology Stack
GeoGnos is built for performance. We utilize a modern, serverless stack to ensure global availability and low latency:
* **Frontend:** SvelteKit v2+ & Svelte v5 (Runes)
* **Styling:** Tailwind CSS v4
* **Infrastructure:** Cloudflare Workers
* **3D Globe:** [Cobe](https://cobe.vercel.app/)
---
## User Guide
Welcome to the future of data exploration. GeoGnos is designed to make global geography, statistics, and history instantly accessible, engaging, and easy to compare.
### 1. Exploring Places & History
Navigate to the [Places](/en/places) section to browse the complete list of 260+ world entities.
* **Search**: Use the fuzzy search bar at the top to instantly find any country or territory by name, code, or region (with Levenshtein-distance typo tolerance).
* **Country Profiles**: Click on any country card to view its detailed dossier (e.g., [Greece Dossier](/en/place/greece)):
* **Dashboard**: At the top, you'll find key indicators (Population, GDP, Area, Capital) and an interactive map.
* **Deep Data**: Scroll down to explore comprehensive data across categories like Geography, Economy, People, and Government.
* **Historical Timeline**: Click the Options menu or the link in the "Introduction" card to open the country's Chronological History Timeline (e.g., [Greece History Timeline](/en/place/greece/history)). Explore major milestones, a 4x4 interactive visual sprite grid, and deep editorial analysis (complete with country/world impact scores, key figures, and geo-locations).
### 2. Interactive Data Games & Showcases
GeoGnos provides rich, visual ways to study history and geography:
* **Chronology Puzzle**: Accessible from the timeline's Options menu, this drag-and-drop game challenges you to order historical events chronologically (e.g., [Greece Chronology Puzzle](/en/place/greece/history/puzzle)).
* Select from multiple difficulty levels (4, 8, 12, or 16 events) and modes (Local/World impact focus).
* Toggle transient date hints to help you when stuck.
* Unlock local and global achievements in your local browser **Trophy Room**.
* **Cinematic Showcases**: Accessible from the country's Options menu or the navigation header, these let you explore 3D cinematic timelines of country history milestones (e.g., [Greece Visual Showcase](/en/place/greece/visuals/history)) or points of interest (e.g., [Greece Points of Interest Showcase](/en/place/greece/visuals/points-of-interest)). Navigate the timeline using the on-screen play controls or by pressing the **Left/Right Arrow keys** on your keyboard or by pressing the buttons row above. Cycle through a beautiful 3D perspective scroll, read detailed illustration/POI descriptions, or search for other countries. Toggle the autoplay settings (including loop and auto-play playlist modes) to watch the timeline advance automatically.
### 3. Global Country Synchronization
GeoGnos automatically remembers your active country as you browse.
* If you select Singapore in the **Visual Showcase** and then navigate to the **Places** profile or the **Chronology Puzzle**, GeoGnos will automatically synchronize and load Singapore for you.
* The **History Visuals** link in the navigation header updates dynamically to point directly to your last selected country.
### 4. Global Rankings
The [Rankings](/en/rankings) section is a powerful tool for comparative analysis.
* **Choose a Metric**: Select from dozens of statistical indicators (e.g., *Refugees*, *Internet Users*, *Natural Gas Exports*).
* **Filter by Group**: Use the "Group" filter to narrow down the list to specific organizations like the **EU**, **NATO**, **G7**, or **OPEC**.
* **Compare Mode**: Select multiple countries from the list to see them side-by-side.
* **Share Your View**: The URL updates automatically as you filter and select. Copy the link to share your specific data view with others.
### 5. Tips & Tricks
* **Dark Mode**: Toggle the sun/moon icon in the top right to switch between light and dark themes.
* **Quick Search**: Press `/` (forward slash) on your keyboard to focus the search bar from anywhere in the app.
* **Share**: Click the **Share** button in the header (or on individual pages) to quickly copy the current page link or share it to social media.