Integrate the family events API
Start integrating FindKobi’s Bay Area events API: free Community tier, demo JSON feed, Bearer auth, usage limits, and copy-paste code for JSON, RSS, and CSV exports.
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.
Copy-paste integration
Plain HTTP GET — no SDK. Demo needs no key; live calls use Authorization: Bearer fk_live_… (or api_key=).
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.
Copy-paste integration
Plain HTTP GET — no SDK. Demo needs no key; live calls use Authorization: Bearer fk_live_… (or api_key=).
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
seasonalandfestivalscategories - 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