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.

The most common event categories are listed in the two keyword sets helsinki:topics and helsinki:audiences, which list the YSO keywords that are present in most events to specify event main topic and audience.

Keyword text

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

Example:

keyword/?text=lapset

See the result

Free text

While the previous search is looking for the keywords containg exact matches of the search string, free_text retrieves keywords on the basis of similarity. Results are sorted by similarity.

Example:

keyword/?free_text=lapppset

See the result

Keyword source

Will restrict keywords to a specific data source.

Example:

keyword/?data_source=yso

See the result

Show only keywords with the upcoming events

To show only the keywords which are used in the upcoming events supply the has_upcoming_events query parameter.

For example:

keyword/?has_upcoming_events=True

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.

For example:

keyword/?show_all_keywords=True

See the result

Showing deprecated keywords

By default, deprecated keywords are not displayed. You may also display deprecated keywords with the query parameter show_deprecated.

For example:

keyword/?show_deprecated=True

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

GET /linkedevents/v1/keyword/?format=api&page=174
HTTP 200 OK
Allow: GET, POST, HEAD, OPTIONS
Content-Type: application/json ;utf-8
Vary: Accept

{
    "meta": {
        "count": 3485,
        "next": "http://api.hel.fi/linkedevents/v1/keyword/?format=api&page=175",
        "previous": "http://api.hel.fi/linkedevents/v1/keyword/?format=api&page=173"
    },
    "data": [
        {
            "id": "espoo_le:aggh5gwk74",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:22.946234Z",
            "last_modified_time": "2023-12-18T20:25:22.946251Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 9,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Vanha-Nuuksio",
                "sv": "Gamla Noux",
                "en": "Vanha-Nuuksio"
            },
            "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwk74/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwmpm",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.327024Z",
            "last_modified_time": "2023-12-18T20:25:23.327043Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 8,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "erityisryhmät",
                "sv": "specialgrupper",
                "en": "special groups"
            },
            "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwmpm/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwlxq",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.134929Z",
            "last_modified_time": "2023-12-18T20:25:23.134947Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 8,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Karakallio",
                "sv": "Karabacka",
                "en": "Karakallio"
            },
            "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwlxq/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwk4m",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:22.918312Z",
            "last_modified_time": "2023-12-18T20:25:22.918331Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 8,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Kolmperä",
                "sv": "Kolmpers",
                "en": "Kolmperä"
            },
            "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwk4m/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwloq",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.064370Z",
            "last_modified_time": "2023-12-18T20:25:23.064425Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 8,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Lippajärvi",
                "sv": "Klappträsk",
                "en": "Lippajärvi"
            },
            "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwloq/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwmny",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.312874Z",
            "last_modified_time": "2023-12-18T20:25:23.312900Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 8,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "matkailijat",
                "sv": "besökare",
                "en": "visitors"
            },
            "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwmny/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwlrm",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.086792Z",
            "last_modified_time": "2023-12-18T20:25:23.086817Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 7,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Bodom",
                "sv": "Bodom",
                "en": "Bodom"
            },
            "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwlrm/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwmje",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.276441Z",
            "last_modified_time": "2023-12-18T20:25:23.276462Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 7,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Henttaa",
                "sv": "Hemtans",
                "en": "Henttaa"
            },
            "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwmje/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwlwa",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.122804Z",
            "last_modified_time": "2023-12-18T20:25:23.122823Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 7,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Järvenperä",
                "sv": "Träskända",
                "en": "Järvenperä"
            },
            "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwlwa/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwk3u",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:22.912719Z",
            "last_modified_time": "2023-12-18T20:25:22.912739Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 7,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Karvasmäki",
                "sv": "Karvasbacka",
                "en": "Karvasmäki"
            },
            "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwk3u/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwlqq",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.079598Z",
            "last_modified_time": "2023-12-18T20:25:23.079624Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 7,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Kunnarla",
                "sv": "Gunnars",
                "en": "Kunnarla"
            },
            "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwlqq/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwmou",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.319996Z",
            "last_modified_time": "2023-12-18T20:25:23.320023Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 7,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "vammaiset",
                "sv": "funktionsnedsatta",
                "en": "disabled"
            },
            "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwmou/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwk5i",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:22.924999Z",
            "last_modified_time": "2023-12-18T20:25:22.925016Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 6,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Kuurinniitty",
                "sv": "Kurängen",
                "en": "Kuurinniitty"
            },
            "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwk5i/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwmae",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.204267Z",
            "last_modified_time": "2023-12-18T20:25:23.204289Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 6,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Niipperi",
                "sv": "Nipert",
                "en": "Niipperi"
            },
            "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwmae/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwlsq",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.095834Z",
            "last_modified_time": "2023-12-18T20:25:23.095864Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 6,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Röylä",
                "sv": "Rödskog",
                "en": "Röylä"
            },
            "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwlsq/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwk64",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:22.938375Z",
            "last_modified_time": "2023-12-18T20:25:22.938424Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 6,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Siikajärvi",
                "sv": "Siikajärvi",
                "en": "Siikajärvi"
            },
            "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwk64/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwlbq",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:22.958932Z",
            "last_modified_time": "2023-12-18T20:25:22.958948Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 6,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Ämmässuo",
                "sv": "Käringmossen",
                "en": "Ämmässuo"
            },
            "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwlbq/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwmka",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.283302Z",
            "last_modified_time": "2023-12-18T20:25:23.283318Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 5,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Högnäs",
                "sv": "Högnäs",
                "en": "Högnäs"
            },
            "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwmka/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwl3m",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.167428Z",
            "last_modified_time": "2023-12-18T20:25:23.167459Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 5,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Lakisto",
                "sv": "Lakisto",
                "en": "Lakisto"
            },
            "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwl3m/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwmcm",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.222221Z",
            "last_modified_time": "2023-12-18T20:25:23.222237Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 5,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Perusmäki",
                "sv": "Grundbacka",
                "en": "Perusmäki"
            },
            "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwmcm/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}