Skip to content
Docs · Introduction

Kindred for developers

Put real events on your site.

The Kindred Events API gives you upcoming public events, worldwide, as clean JSON. List them in your website, app or newsletter, with links back to tickets and the event on Kindred.

Base URL
https://www.kindredoo.com/api/v1
Auth
Bearer API key
Key format
kd_live_…
Free tier
1,000 requests / month
  • Events worldwide

    Kindred-curated events and events checked on the organiser's own page, from Lagos to Buenos Aires.

  • Plain REST + JSON

    Four GET endpoints, ISO dates with time zones, ETags and CORS. Works from any language.

  • Public data only

    Only published, upcoming, public events. Never member data, drafts or anything under review.

Your first request

Send your key in the Authorization header. This lists upcoming music events in Nigeria, soonest first:

curl "https://www.kindredoo.com/api/v1/events?country=NG&category=music&limit=10" \
  -H "Authorization: Bearer $KINDRED_API_KEY"

Every event comes back in the same shape:

200Event object
{
  "id": "dx-mi3k2a-7f2q1c",
  "slug": "futurefest-26-convergence-lagos-2026-12-11",
  "title": "FutureFest '26 Convergence",
  "category": "festival",
  "category_label": "Festivals",
  "start": "2026-12-11T16:00:00+01:00",
  "end": "2026-12-20T23:00:00+01:00",
  "time_known": true,
  "timezone": "Africa/Lagos",
  "venue": "Eko Atlantic",
  "city": "Lagos",
  "region": null,
  "country": "NG",
  "country_name": "Nigeria",
  "summary": "Ten days of music, tech talks and art installations by the Atlantic.",
  "price": "From ₦25,000",
  "images": {
    "card": "https://www.kindredoo.com/events/futurefest-26-convergence-lagos-2026-12-11/image/card-k3f9.webp",
    "og": "https://www.kindredoo.com/events/futurefest-26-convergence-lagos-2026-12-11/image/og-k3f9.jpg"
  },
  "kindred_url": "https://www.kindredoo.com/events/futurefest-26-convergence-lagos-2026-12-11",
  "ticket_url": "https://app.futurefest.live/tickets",
  "official_url": "https://app.futurefest.live/",
  "source": "discovered",
  "updated_at": "2026-11-16T14:53:14.000Z"
}

Endpoints

What you can build

  • A "What's on this weekend" section for a city guide, blog or hotel site.
  • Category feeds (comedy, food, tech) for a community app or newsletter.
  • A country page with every upcoming festival, linked to official tickets.
  • Bots and widgets: post tomorrow's events to a channel every morning.

Attribution and fair use

On the Free plan, show “Powered by Kindred” with a link to kindredoo.com next to the events, and keep it non-commercial. Pro allows commercial use. Always link each event to its kindred_url or ticket_url, keep dates as we send them, and refresh at least daily so cancelled or finished events drop off.

Start building with Kindred events

Create a free key in a minute with your Kindred account. Upgrade to Pro when you go commercial.