Get started

Introduction

For newsletters, media, apps, and integrations — not consumer weekend browsing. Coverage: San Francisco Bay Area, CA.

1. Create an account

Open your developer account (Google or email). Your organization is auto-provisioned on the free Community plan for integration trials.

2. Copy your API key

Keys look like fk_live_…. They are shown once — store them securely. Pass as Authorization: Bearer … or api_key= query param.

const url = "https://www.findkobi.com/api/v1/demo/events?city=oakland&age_min=2&age_max=4&week=current&limit=10";

const res = await fetch(url, {
  headers: {
    "Accept": "application/json"
  },
});
if (!res.ok) throw new Error(await res.text());
const data = await res.json();
console.log(data.events.map((e) => e.title));

3. Live formats (key required)

• JSON: https://api.findkobi.com/v1/events
• CSV: https://api.findkobi.com/v1/events.csv
• RSS: https://api.findkobi.com/v1/feed.rss
• JSON Feed: https://api.findkobi.com/v1/feed.json

On www.findkobi.com today, prefix with /api (e.g. https://www.findkobi.com/api/v1/events). Use the integration panel above — switch to Live API for Bearer or api_key snippets.

const url = "https://www.findkobi.com/api/v1/events?city=oakland&age_min=2&age_max=4&week=current&limit=10";

const res = await fetch(url, {
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_KEY"
  },
});
if (!res.ok) throw new Error(await res.text());
const data = await res.json();
console.log(data.events.map((e) => e.title));

Community limits

• 25 matched records per calendar month (hard cap) — enough to prototype an embed or newsletter block
• Excludes seasonal and festivals categories
• Attribution required — link to FindKobi when displaying events
• Browsing findkobi.com as a parent does not count toward this quota

GET https://api.findkobi.com/v1/usage?api_key=YOUR_KEY