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": 3507,
        "next": "https://api.hel.fi/linkedevents/v1/keyword/?format=api&page=175",
        "previous": "https://api.hel.fi/linkedevents/v1/keyword/?format=api&page=173"
    },
    "data": [
        {
            "id": "espoo_le:aggh5gwmde",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.227877Z",
            "last_modified_time": "2023-12-18T20:25:23.227893Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 36,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Pohjois-Tapiola",
                "sv": "Norra Hagalund",
                "en": "Pohjois-Tapiola"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwmde/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwmba",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.211139Z",
            "last_modified_time": "2023-12-18T20:25:23.211158Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 35,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Niittykumpu",
                "sv": "Ängskulla",
                "en": "Niittykumpu"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwmba/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwl5u",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.184339Z",
            "last_modified_time": "2023-12-18T20:25:23.184368Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 31,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Latokaski",
                "sv": "Ladusved",
                "en": "Latokaski"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwl5u/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwlyi",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.141049Z",
            "last_modified_time": "2023-12-18T20:25:23.141068Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 26,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Kauklahti",
                "sv": "Köklax",
                "en": "Kauklahti"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwlyi/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwlkm",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.029827Z",
            "last_modified_time": "2023-12-18T20:25:23.029843Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 25,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Suvisaaristo",
                "sv": "Sommaröarna",
                "en": "Suvisaaristo"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwlkm/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwmby",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.217028Z",
            "last_modified_time": "2023-12-18T20:25:23.217046Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 23,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Nuuksio",
                "sv": "Noux",
                "en": "Nuuksio"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwmby/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwmhy",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.264956Z",
            "last_modified_time": "2023-12-18T20:25:23.264973Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 23,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Westend",
                "sv": "Westend",
                "en": "Westend"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwmhy/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwltq",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.104220Z",
            "last_modified_time": "2023-12-18T20:25:23.104245Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 22,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Laajalahti",
                "sv": "Bredvik",
                "en": "Laajalahti"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwltq/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwlay",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:22.952878Z",
            "last_modified_time": "2023-12-18T20:25:22.952896Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 18,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Gumböle",
                "sv": "Gumböle",
                "en": "Gumböle"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwlay/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwlda",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:22.971079Z",
            "last_modified_time": "2023-12-18T20:25:22.971095Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 18,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Otaniemi",
                "sv": "Otnäs",
                "en": "Otaniemi"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwlda/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwl4m",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.175628Z",
            "last_modified_time": "2023-12-18T20:25:23.175656Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 16,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Espoonkartano",
                "sv": "Esbogård",
                "en": "Espoonkartano"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwl4m/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwk24",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:22.905740Z",
            "last_modified_time": "2023-12-18T20:25:22.905760Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 16,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Karhusuo",
                "sv": "Björnkärr",
                "en": "Karhusuo"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwk24/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwlzu",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.151813Z",
            "last_modified_time": "2023-12-18T20:25:23.151830Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 16,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Kurttila",
                "sv": "Kurtby",
                "en": "Kurttila"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwlzu/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwmgi",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.253155Z",
            "last_modified_time": "2023-12-18T20:25:23.253171Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 16,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Vanttila",
                "sv": "Fantsby",
                "en": "Vanttila"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwmgi/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwley",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:22.985450Z",
            "last_modified_time": "2023-12-18T20:25:22.985468Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 14,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Kalajärvi",
                "sv": "Kalajärvi",
                "en": "Kalajärvi"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwley/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwlpq",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.071699Z",
            "last_modified_time": "2023-12-18T20:25:23.071718Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 14,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Viherlaakso",
                "sv": "Gröndal",
                "en": "Viherlaakso"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwlpq/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwlmu",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.048865Z",
            "last_modified_time": "2023-12-18T20:25:23.048889Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 13,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Laaksolahti",
                "sv": "Dalsvik",
                "en": "Laaksolahti"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwlmu/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwlci",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:22.965134Z",
            "last_modified_time": "2023-12-18T20:25:22.965149Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 12,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Keilaniemi",
                "sv": "Kägeludden",
                "en": "Keilaniemi"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwlci/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwlve",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.116299Z",
            "last_modified_time": "2023-12-18T20:25:23.116318Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 12,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Online-tapahtuma",
                "sv": "Online-evenemang",
                "en": "Online event"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwlve/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggh5gwl2m",
            "alt_labels": [],
            "created_time": "2023-12-18T20:25:23.158779Z",
            "last_modified_time": "2023-12-18T20:25:23.158807Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 11,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Lahnus",
                "sv": "Lahnus",
                "en": "Lahnus"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwl2m/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}