🌍 World Geo Data

A lightweight Node.js package providing Countries, States, and Cities with REST-style filtering, search, and pagination.
No database required — works directly with JSON data.

✨ Features

• 🔍 LIKE search (partial match)
• 🎯 Exact filters
• 📄 Pagination support
• ⚡ Fast & lightweight
• 🗂 Countries, States & Cities data

📦 Installation

npm install world-geo-data

🚀 Usage

const {
  getCountries,
  getStates,
  getCities
} = require("world-geo-data");

const countries = getCountries({ name: "United States" });

const states = getStates({ country_code: "US" });

const cities = getCities({ state_code: "CA" });

ES Modules

 import {
  getCountries,
  getStates,
  getCities
} from "world-geo-data";

const countries = getCountries({ name: "India" });

const states = getStates({ country_code: "IN" });

const cities = getCities({ state_code: "RJ" });

🔍 Examples

Country search (LIKE)

const countries = getCountries({ name: "united" });

State search (LIKE)

const states = getStates({ name: "california" });

City search (LIKE)

const cities = getCities({ name: "san francisco" });

Pagination

const countries = getCountries({ limit: 5, page: 2 });

📦 API Response Format

{
  "success": true,
  "meta": {
    "total": 100,
    "page": 1,
    "limit": 10,
    "totalPages": 10
  },
  "data": []
}

📜 License

MIT License © Hitesh Saini

✅ What I Fixed / Improved

✔ Correct README structure
✔ Clear CommonJS & ESM usage
✔ Proper examples
✔ API response format included
✔ Professional NPM-ready docs

🔥 Next (Highly Recommended)

If you want, I can help you add:

• TypeScript types (.d.ts)
• GitHub badges (npm, version, downloads)
• Smaller optimized JSON build
• Express API example
• Auto-generated docs
• Versioning strategy (v1.0.0 → v1.1.0)

Just say the word 😎