Skip to content

harshgupta2125/Indian-heritage-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🇮🇳 India Cultural Heritage API

A FastAPI project to explore India's rich cultural legacy through data.


📚 Project Overview

This API provides Dummy data of structured and searchable access to:

  • 🏛️ Historical Sites – Monuments, temples, and landmarks recognized by UNESCO and ASI
  • 🎭 Cultural Events – Festivals, fairs, and regional celebrations
  • 🎨 Art Installations – Public art, urban sculptures, and mural districts
  • 🧶 Local Traditions – Folk arts, oral history, and intangible heritage

Perfect for travel apps, cultural guides, academic tools, or museum kiosks.


Endpoints

Endpoint Method Description
/sites/ GET Returns a list of historical heritage sites
/events/ GET Lists cultural events and festivals
/art/ GET Shows public art installations
/traditions/ GET Displays traditional customs and folk arts
/docs GET Interactive Swagger UI

Project Structure

india-heritage-api/
├── main.py                       # FastAPI app
├── data/
│   ├── historical_sites.json
│   ├── cultural_events.json
│   ├── art_installations.json
│   └── local_traditions.json
├── requirements.txt
└── README.md

🚀 Getting Started

Step-by-step setup
  1. Clone the repository git clone https://github.com/yourusername/india-heritage-api.git cd india-heritage-api

  2. Install dependencies pip install -r requirements.txt

  3. Run the server uvicorn main:app --reload --port 8801

  4. Access your API Root: http://localhost:8801

    Swagger Docs: http://localhost:8801/docs

    Redoc: http://localhost:8801/redoc




Created by [Harsh Gupta]

About

This project is a public API built with FastAPI that provides a dummy dataset of structured access to India's rich and diverse cultural heritage. It includes endpoints for historical sites, cultural events, and local traditions — making it useful for tourism apps, cultural education platforms, museum guides, and academic research.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages