Partner Events API

Show IndianEvents.org events on any section, topic or location page of Indias.com, Kerala.com, CivicPulse.blog and other partner sites. Free, no key needed, refreshed every 5 minutes.

Address

GET https://indianevents.org/api/public/v1/events

place — location path, includes everything below it: in, in/kerala, in/kerala/ernakulam
topic — event category (list below)
from / to — dates as YYYY-MM-DD
limit — 1 to 200 (default 20)
format — json (default), rss, or html (ready-to-paste list); theme=light|dark for html
ref — your site name, e.g. kerala.com, added to links so visits from each site can be counted

Topics

festivals-cultural · Festivals & Culturalcommunity-events · Community Eventsbusiness-networking · Business & Networkingeducation-seminars · Education & Seminarsreligious-spiritual · Religious & Spiritualweddings-family · Weddings & Familysports-fitness · Sports & Fitnessarts-exhibition · Arts & Exhibitionfood-culinary · Food & Culinarytravel-tourism · Travel & Tourismmeetups-social · Meetups & Socialmovies-music · Movies & Music

Examples

Indias.com — Kerala state page

https://indianevents.org/api/public/v1/events?place=in/kerala&ref=indias.com

Kerala.com — Ernakulam festivals

https://indianevents.org/api/public/v1/events?place=in/kerala/ernakulam&topic=festivals-cultural&ref=kerala.com

CivicPulse.blog — community events (RSS)

https://indianevents.org/api/public/v1/events?topic=community-events&format=rss&ref=civicpulse.blog

Any page — ready-made HTML list

https://indianevents.org/api/public/v1/events?place=in/tamil-nadu&topic=movies-music&format=html&limit=5

Paste-in code for a page

<div id="ie-events"></div>
<script>
fetch("https://indianevents.org/api/public/v1/events?place=in/kerala&format=html&limit=6&ref=kerala.com")
  .then(r => r.text()).then(h => document.getElementById("ie-events").innerHTML = h);
</script>

Or use the styled widget: <iframe src="https://indianevents.org/embed/in/kerala" width="100%" height="480"></iframe>. The full list of places with events is at https://indianevents.org/api/public/all.