API reference · v1
Events API
Search current family and kids events by location, date, age, category, and more.
Endpoint
GET https://api.findkobi.com/v1/events
Export formats
Events are also available as CSV, RSS, and JSON Feed.
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
Authentication
Pass your API key using the api_key query parameter.
api_key=fk_live_…
Try a request
const url = "https://api.findkobi.com/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));Parameters
Age filters use age_min and age_max in years. They match events whose enjoyment age range overlaps that window.
| Parameter | Type | Description |
|---|---|---|
| city | string | Filter by city |
| lat | number | Latitude for radius search |
| lng | number | Longitude for radius search |
| radius_km | number | Search radius in kilometers |
| age_min | number | Minimum child age in years |
| age_max | number | Maximum child age in years |
| category | string | Filter by category |
| q | string | Search events |
| is_free | boolean | Return free events only |
| start_date | date | Events on or after this date |
| end_date | date | Events on or before this date |
| limit | integer | Number of results to return |
| offset | integer | Number of results to skip |
Fields by plan
Some response fields depend on your plan. Capability flags such as has_age_data, has_geo, and has_social_profiles indicate when enriched data is available.
- Community: Core event fields
- Starter: Core fields + location data
- Growth: Full enriched event data, including age ranges and available venue details
Response fields
| Name | Type | Description |
|---|---|---|
| id | string | Stable FindKobi event identifier (bsc_evt_…). |
| title | string | Event name. |
| description | string | null | Plain-text description (HTML stripped when present). |
| summary | string | null | Short plain-text blurb; falls back to truncated description. |
| start_datetime | string (ISO 8601) | Start time with timezone offset. |
| end_datetime | string (ISO 8601) | End time when known. |
| venue.name | string | Venue or place name. |
| venue.address | string | Single-line street address. |
| venue.lat | number | Latitude (WGS84). |
| venue.lng | number | Longitude (WGS84). |
| organizer | string | null | Host organization when known (e.g. Oakland Public Library); venue.name is the branch/room. |
| organizer_url | string | null | Organizer website when available. |
| categories | string[] | Normalized category slugs. |
| tags | string[] | Additional topical tags. |
| image_url | string | null | Primary cover image URL. |
| is_free | boolean | True when admission is free. |
| price | object | null | min, max, note when pricing is known. |
| ticket_url | string | null | Host registration URL when on-library/civic site; otherwise use event_url. |
| source | string | null | Optional host domain for attribution (library/museum/gov) — never ingest pipeline ids. |
| destination | string | Destination slug (metro / city cluster). |
| age_range | object | null | min_months, max_months (canonical storage units). |
| age_range_years | object | null | min_years, max_years — mirrors friendly age_min/age_max filters. |
| is_canceled | boolean | Cancellation flag. |
| event_url | string | null | FindKobi canonical event URL. Availability varies by plan. |
| has_social_profiles | boolean | True when the linked approved place has stored social profile URLs. URLs are omitted below enriched tier. |
| venue.social_profiles | object | null | Official venue social URLs (facebook, instagram, x, youtube, tiktok, linkedin, pinterest, threads, bsky). Enriched tier and above only. |
Usage & rate limits
Live requests count events returned toward your monthly plan quota (Community 125, Starter 500, Growth 2,000 events per month). Check remaining credits with GET /v1/usage or the dashboard Overview. Community excludes seasonal and festival events.
Versioning
The current API version is v1.
Breaking changes use a new version path, such as /v2/. New fields may be added without a version change, so clients should ignore unknown JSON keys.
Changelog
- 2026-09-22: Added
venue.social_profilesandhas_social_profiles(enriched tier and above for URLs).
More ways to use FindKobi
Website Widgets
Add family events directly to your website.
Newsletter Blocks
Create event sections for your newsletter.
Calendar Feeds
Give your audience a calendar they can follow.
Events API
Build family event data into your own product.