README.md

---
title: CreatorPulse India API
emoji: 📊
colorFrom: indigo
colorTo: green
sdk: docker
app_port: 7860
pinned: false
---

# CreatorPulse India — API

FastAPI backend for CreatorPulse India: creator discovery, channel profiles,
niche-demand forecasts, and brand → creator matching over a YouTube Data API
corpus of 12,547 Indian creators.

**Endpoints**

- `GET /healthz` — liveness
- `GET /stats` — corpus summary
- `GET /creators?q=&limit=` — search creators
- `GET /creators/{channel_id}` — single creator profile
- `GET /niches/{niche}/forecast` — niche demand forecast
- `POST /match` — rank creators for a campaign brief (semantic fit, niche overlap,
  fraud risk, budget fit, reach)

Built by [Ayush Gupta](https://github.com/ayushgupta07xx).