Using the keyword endpoint

Here, categories for events are listed. Events in each category can be found at the event endpoint using the query parameter keyword. The common keywords used in all events originate from the general Finnish ontology (yso), hence the format yso:p4354. Default ordering is decreasing order by the number of events found.

Keyword text

To find keywords that contain a specific string, use the query parameter text.

Example:

keyword/?text=lapset

See the result

Keyword source

Will restrict keywords to a specific data source.

Example:

keyword/?data_source=yso

See the result

Ordering

Default ordering is decreasing order by the number of events found. You may also order results by name. For example:

keyword/?sort=name

See the result

Showing all keywords

By default, only those keywords which have listed events are displayed. You may display keywords with zero n_events with the query parameter show_all_keywords.

GET /linkedevents/v0.1/keyword/
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json ;utf-8
Vary: Accept

{
    "meta": {
        "count": 1703,
        "next": "http://api.hel.fi/linkedevents/v0.1/keyword/?page=2",
        "previous": null
    },
    "data": [
        {
            "id": "yso:p4354",
            "alt_labels": [
                "spädbarn",
                "lapset",
                "imeväisikäiset",
                "barn"
            ],
            "created_time": "2014-06-23T11:37:27.705000Z",
            "last_modified_time": "2017-09-06T05:20:47.061426Z",
            "origin_id": null,
            "aggregate": false,
            "deprecated": false,
            "n_events": 41203,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "name": {
                "fi": "lapset (ikäryhmät)",
                "sv": "barn (åldersgrupper)",
                "en": "children (age groups)"
            },
            "@id": "http://api.hel.fi/linkedevents/v0.1/keyword/yso:p4354/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4363",
            "alt_labels": [
                "ydinperheet",
                "perhe",
                "familjer (grupper)",
                "kärnfamiljer",
                "familj"
            ],
            "created_time": "2014-06-23T11:37:28.246000Z",
            "last_modified_time": "2019-05-11T04:20:04.577893Z",
            "origin_id": null,
            "aggregate": false,
            "deprecated": false,
            "n_events": 25531,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "name": {
                "fi": "perheet",
                "sv": "familjer",
                "en": "families"
            },
            "@id": "http://api.hel.fi/linkedevents/v0.1/keyword/yso:p4363/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11617",
            "alt_labels": [
                "nuoriso",
                "unga"
            ],
            "created_time": "2014-06-23T11:37:27.563000Z",
            "last_modified_time": "2017-09-06T05:20:59.293091Z",
            "origin_id": null,
            "aggregate": false,
            "deprecated": false,
            "n_events": 23930,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "name": {
                "fi": "nuoret",
                "sv": "ungdomar",
                "en": "young people"
            },
            "@id": "http://api.hel.fi/linkedevents/v0.1/keyword/yso:p11617/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p360",
            "alt_labels": [],
            "created_time": "2014-06-23T11:37:29.198000Z",
            "last_modified_time": "2017-09-06T05:20:25.832872Z",
            "origin_id": null,
            "aggregate": false,
            "deprecated": false,
            "n_events": 18411,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "name": {
                "fi": "kulttuuritapahtumat",
                "sv": "kulturevenemang",
                "en": "cultural events"
            },
            "@id": "http://api.hel.fi/linkedevents/v0.1/keyword/yso:p360/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1808",
            "alt_labels": [
                "musiikki",
                "musikkonst",
                "säveltaide"
            ],
            "created_time": "2014-06-23T11:37:28.044000Z",
            "last_modified_time": "2017-09-06T05:20:22.016421Z",
            "origin_id": null,
            "aggregate": false,
            "deprecated": false,
            "n_events": 15023,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "name": {
                "fi": "musiikki",
                "sv": "musik",
                "en": "music"
            },
            "@id": "http://api.hel.fi/linkedevents/v0.1/keyword/yso:p1808/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6165",
            "alt_labels": [
                "immigrantit",
                "immigranter"
            ],
            "created_time": "2014-06-23T11:37:28.630000Z",
            "last_modified_time": "2018-06-18T02:20:20.340757Z",
            "origin_id": null,
            "aggregate": false,
            "deprecated": false,
            "n_events": 14599,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "name": {
                "fi": "maahanmuuttajat",
                "sv": "invandrare",
                "en": "migrants"
            },
            "@id": "http://api.hel.fi/linkedevents/v0.1/keyword/yso:p6165/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2625",
            "alt_labels": [
                "scenkonst",
                "teaterkonst",
                "näyttämötaide",
                "teatteritaide",
                "teatteri",
                "dramatic art",
                "teatteri (taiteet)",
                "teater",
                "teater (konstarter)"
            ],
            "created_time": "2014-06-23T11:37:27.748000Z",
            "last_modified_time": "2018-08-25T02:20:10.908542Z",
            "origin_id": null,
            "aggregate": false,
            "deprecated": false,
            "n_events": 14412,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "name": {
                "fi": "teatteritaide",
                "sv": "teaterkonst",
                "en": "theatre"
            },
            "@id": "http://api.hel.fi/linkedevents/v0.1/keyword/yso:p2625/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2434",
            "alt_labels": [
                "ikäihmiset",
                "ikä-ihmiset",
                "gamlingar"
            ],
            "created_time": "2014-06-23T11:37:30.235000Z",
            "last_modified_time": "2017-09-06T05:21:00.759239Z",
            "origin_id": null,
            "aggregate": false,
            "deprecated": false,
            "n_events": 14363,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "name": {
                "fi": "vanhukset",
                "sv": "åldringar",
                "en": "elderly"
            },
            "@id": "http://api.hel.fi/linkedevents/v0.1/keyword/yso:p2434/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18105",
            "alt_labels": [
                "nyhetsgrupper",
                "uutisryhmät"
            ],
            "created_time": "2014-06-23T11:37:25.345000Z",
            "last_modified_time": "2017-09-06T05:20:46.419112Z",
            "origin_id": null,
            "aggregate": false,
            "deprecated": false,
            "n_events": 13054,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "name": {
                "fi": "keskusteluryhmät",
                "sv": "diskussionsgrupper",
                "en": "discussion groups"
            },
            "@id": "http://api.hel.fi/linkedevents/v0.1/keyword/yso:p18105/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2149",
            "alt_labels": [
                "opastukset"
            ],
            "created_time": "2014-06-23T11:37:25.994000Z",
            "last_modified_time": "2017-09-06T05:21:07.924133Z",
            "origin_id": null,
            "aggregate": false,
            "deprecated": false,
            "n_events": 12205,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "name": {
                "fi": "opastus",
                "sv": "guidning",
                "en": "guidance"
            },
            "@id": "http://api.hel.fi/linkedevents/v0.1/keyword/yso:p2149/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9270",
            "alt_labels": [],
            "created_time": "2014-06-23T11:37:26.899000Z",
            "last_modified_time": "2017-09-06T05:19:59.267957Z",
            "origin_id": null,
            "aggregate": false,
            "deprecated": false,
            "n_events": 11496,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "name": {
                "fi": "kurssit",
                "sv": "kurser",
                "en": "courses (societal objects)"
            },
            "@id": "http://api.hel.fi/linkedevents/v0.1/keyword/yso:p9270/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2108",
            "alt_labels": [
                "evenemang",
                "incidents",
                "händelser",
                "evenemang och händelser"
            ],
            "created_time": "2014-06-23T11:37:28.601000Z",
            "last_modified_time": "2019-05-11T04:20:01.640718Z",
            "origin_id": null,
            "aggregate": false,
            "deprecated": false,
            "n_events": 10322,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "name": {
                "fi": "tapahtumat",
                "sv": "händelser och evenemang",
                "en": "events"
            },
            "@id": "http://api.hel.fi/linkedevents/v0.1/keyword/yso:p2108/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16485",
            "alt_labels": [
                "peruskoululaiset"
            ],
            "created_time": "2014-06-23T11:37:26.180000Z",
            "last_modified_time": "2017-09-06T05:20:45.137409Z",
            "origin_id": null,
            "aggregate": false,
            "deprecated": false,
            "n_events": 9365,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "name": {
                "fi": "koululaiset",
                "sv": "skolelever",
                "en": "pupils"
            },
            "@id": "http://api.hel.fi/linkedevents/v0.1/keyword/yso:p16485/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14710",
            "alt_labels": [],
            "created_time": "2014-06-23T11:37:28.359000Z",
            "last_modified_time": "2017-09-06T05:20:12.978120Z",
            "origin_id": null,
            "aggregate": false,
            "deprecated": false,
            "n_events": 8835,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "name": {
                "fi": "satutunnit",
                "sv": "sagotimmar",
                "en": "story hours"
            },
            "@id": "http://api.hel.fi/linkedevents/v0.1/keyword/yso:p14710/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13050",
            "alt_labels": [],
            "created_time": "2014-06-23T11:37:23.969000Z",
            "last_modified_time": "2017-09-06T05:20:32.944169Z",
            "origin_id": null,
            "aggregate": false,
            "deprecated": false,
            "n_events": 7703,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "name": {
                "fi": "lapsiperheet",
                "sv": "barnfamiljer",
                "en": "families with children"
            },
            "@id": "http://api.hel.fi/linkedevents/v0.1/keyword/yso:p13050/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8113",
            "alt_labels": [
                "kirjallisuus",
                "kirjallisuus (taidelajit)"
            ],
            "created_time": "2014-06-23T11:37:28.803000Z",
            "last_modified_time": "2017-09-06T05:20:15.796029Z",
            "origin_id": null,
            "aggregate": false,
            "deprecated": false,
            "n_events": 6715,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "name": {
                "fi": "kirjallisuus",
                "sv": "litteratur",
                "en": "literature"
            },
            "@id": "http://api.hel.fi/linkedevents/v0.1/keyword/yso:p8113/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p556",
            "alt_labels": [
                "språk (typer)",
                "kieli (kielitiede)",
                "kielet",
                "språk (språkvetenskap)",
                "språket"
            ],
            "created_time": "2014-06-23T11:37:23.862000Z",
            "last_modified_time": "2019-05-11T04:19:50.679204Z",
            "origin_id": null,
            "aggregate": false,
            "deprecated": false,
            "n_events": 6537,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "name": {
                "fi": "kieli ja kielet",
                "sv": "språk",
                "en": "languages"
            },
            "@id": "http://api.hel.fi/linkedevents/v0.1/keyword/yso:p556/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8105",
            "alt_labels": [
                "leikkikentät"
            ],
            "created_time": "2014-06-23T11:37:28.731000Z",
            "last_modified_time": "2017-09-06T05:21:10.313676Z",
            "origin_id": null,
            "aggregate": false,
            "deprecated": false,
            "n_events": 5533,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "name": {
                "fi": "leikkipuistot",
                "sv": "lekparker",
                "en": "playgrounds"
            },
            "@id": "http://api.hel.fi/linkedevents/v0.1/keyword/yso:p8105/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11185",
            "alt_labels": [
                "konserter",
                "live-konsertit",
                "konserter (evenemang)",
                "livekonserter"
            ],
            "created_time": "2014-06-23T11:37:29.533000Z",
            "last_modified_time": "2017-09-06T05:21:06.214861Z",
            "origin_id": null,
            "aggregate": false,
            "deprecated": false,
            "n_events": 4649,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "name": {
                "fi": "konsertit",
                "sv": "konserter (framträdanden)",
                "en": "concerts"
            },
            "@id": "http://api.hel.fi/linkedevents/v0.1/keyword/yso:p11185/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p316",
            "alt_labels": [
                "leken",
                "lek (barnlek)",
                "lek",
                "lek (mental aktivitet)",
                "barnlek",
                "leikki (leikkiminen)"
            ],
            "created_time": "2014-06-23T11:37:26.834000Z",
            "last_modified_time": "2019-05-08T04:19:51.933927Z",
            "origin_id": null,
            "aggregate": false,
            "deprecated": false,
            "n_events": 4451,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "name": {
                "fi": "leikkiminen",
                "sv": "lek (aktivitet)",
                "en": "playing (children's games)"
            },
            "@id": "http://api.hel.fi/linkedevents/v0.1/keyword/yso:p316/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}