Skip to main content

    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_…

    Get an API key

    Try a request

    Data:
    GET https://api.findkobi.com/v1/demo/events?city=oakland&age_min=2&age_max=4&week=current&limit=10
    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.

    ParameterTypeDescription
    citystringFilter by city
    latnumberLatitude for radius search
    lngnumberLongitude for radius search
    radius_kmnumberSearch radius in kilometers
    age_minnumberMinimum child age in years
    age_maxnumberMaximum child age in years
    categorystringFilter by category
    qstringSearch events
    is_freebooleanReturn free events only
    start_datedateEvents on or after this date
    end_datedateEvents on or before this date
    limitintegerNumber of results to return
    offsetintegerNumber 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

    NameTypeDescription
    idstringStable FindKobi event identifier (bsc_evt_…).
    titlestringEvent name.
    descriptionstring | nullPlain-text description (HTML stripped when present).
    summarystring | nullShort plain-text blurb; falls back to truncated description.
    start_datetimestring (ISO 8601)Start time with timezone offset.
    end_datetimestring (ISO 8601)End time when known.
    venue.namestringVenue or place name.
    venue.addressstringSingle-line street address.
    venue.latnumberLatitude (WGS84).
    venue.lngnumberLongitude (WGS84).
    organizerstring | nullHost organization when known (e.g. Oakland Public Library); venue.name is the branch/room.
    organizer_urlstring | nullOrganizer website when available.
    categoriesstring[]Normalized category slugs.
    tagsstring[]Additional topical tags.
    image_urlstring | nullPrimary cover image URL.
    is_freebooleanTrue when admission is free.
    priceobject | nullmin, max, note when pricing is known.
    ticket_urlstring | nullHost registration URL when on-library/civic site; otherwise use event_url.
    sourcestring | nullOptional host domain for attribution (library/museum/gov) — never ingest pipeline ids.
    destinationstringDestination slug (metro / city cluster).
    age_rangeobject | nullmin_months, max_months (canonical storage units).
    age_range_yearsobject | nullmin_years, max_years — mirrors friendly age_min/age_max filters.
    is_canceledbooleanCancellation flag.
    event_urlstring | nullFindKobi canonical event URL. Availability varies by plan.
    has_social_profilesbooleanTrue when the linked approved place has stored social profile URLs. URLs are omitted below enriched tier.
    venue.social_profilesobject | nullOfficial 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.

    View changelog

    Changelog

    • 2026-09-22: Added venue.social_profiles and has_social_profiles (enriched tier and above for URLs).

    More ways to use FindKobi

    Explore all products