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 /v1/keyword/?format=api&page=121&show_all_keywords=True
HTTP 200 OK
Allow: GET, POST, HEAD, OPTIONS
Content-Type: application/json ;utf-8
Vary: Accept

{
    "meta": {
        "count": 31675,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=122&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=120&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p17472",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:33.316043Z",
            "last_modified_time": "2023-08-16T05:09:33.316062Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "bokseri",
                "sv": "boxer",
                "en": "boxer (Molossers)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17472/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p30075",
            "has_user_editable_resources": false,
            "alt_labels": [
                "boleroer (danser)",
                "boleror (danser)",
                "boleros (danser)"
            ],
            "created_time": "2023-08-16T05:07:44.620963Z",
            "last_modified_time": "2023-08-16T05:07:44.620995Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "bolero (tanssit)",
                "sv": "bolero (danser)",
                "en": "bolero (dances)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30075/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p30036",
            "has_user_editable_resources": false,
            "alt_labels": [
                "boleroer (kompositioner)",
                "boleros (kompositioner)"
            ],
            "created_time": "2023-08-16T05:11:25.502884Z",
            "last_modified_time": "2023-08-16T05:11:25.502901Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "bolerot (sävellykset)",
                "sv": "boleror (kompositioner)",
                "en": "boleros (compositions)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30036/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22727",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Bulgars"
            ],
            "created_time": "2023-08-16T05:10:20.894394Z",
            "last_modified_time": "2023-08-16T05:10:20.894423Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "bolgaarit",
                "sv": "bolgarer",
                "en": "Bolgars"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22727/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40024",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:11.969308Z",
            "last_modified_time": "2023-08-16T05:08:11.969327Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "bolivialaiset",
                "sv": "bolivianer",
                "en": "Bolivians"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40024/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27755",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:24.856493Z",
            "last_modified_time": "2023-08-16T05:07:24.856510Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "bollywood-tanssi",
                "sv": "bollywooddans",
                "en": "Bollywood (dance)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27755/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20814",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Bologna-prosessi",
                "Bologna processen"
            ],
            "created_time": "2023-08-16T05:13:18.186453Z",
            "last_modified_time": "2023-08-16T05:13:18.186471Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Bolognan prosessi",
                "sv": "Bolognaprocessen",
                "en": "Bologna process"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20814/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21883",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:12.616679Z",
            "last_modified_time": "2023-08-16T05:10:12.616698Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "bolognese",
                "en": "Bolognese dog"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21883/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40513",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2024-11-02T04:40:55.902325Z",
            "last_modified_time": "2024-11-14T04:40:56.785517Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "bolometrit",
                "sv": "bolometrar",
                "en": "bolometers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40513/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6699",
            "has_user_editable_resources": false,
            "alt_labels": [
                "bolshevismi"
            ],
            "created_time": "2023-08-16T05:16:17.995044Z",
            "last_modified_time": "2023-08-16T05:16:17.995061Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "bolševismi",
                "sv": "bolsjevism",
                "en": "Bolshevism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6699/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15575",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Bomarsund"
            ],
            "created_time": "2023-08-16T05:12:52.875229Z",
            "last_modified_time": "2023-08-16T05:12:52.875253Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Bomarsund",
                "sv": "Bomarsunds fästning",
                "en": "Bomarsund"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15575/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21746",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:32.379916Z",
            "last_modified_time": "2023-08-16T05:06:32.379933Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Bomban juhlaviikot",
                "en": "Bomba festivals"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21746/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28427",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Bomba-huset"
            ],
            "created_time": "2023-08-16T05:11:10.346771Z",
            "last_modified_time": "2023-08-16T05:11:10.346789Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Bomban talo",
                "sv": "Bombahuset",
                "en": "Bomba House"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28427/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8622",
            "has_user_editable_resources": false,
            "alt_labels": [
                "bon-po",
                "bön",
                "bön-po",
                "bon (religion)",
                "bön-religion"
            ],
            "created_time": "2023-08-16T05:14:48.602387Z",
            "last_modified_time": "2023-08-16T05:14:48.602414Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "bon",
                "sv": "bon (religioner)",
                "en": "Bon"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8622/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15913",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:37.565065Z",
            "last_modified_time": "2023-08-16T05:05:37.565083Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "BONes",
                "en": "BONes (computer programmes)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15913/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26416",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:43.307530Z",
            "last_modified_time": "2023-08-16T05:15:43.307553Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "bonkei",
                "en": "bonkei"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26416/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4931",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:11.445150Z",
            "last_modified_time": "2023-08-16T05:16:11.445168Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "bonsai",
                "en": "bonsai"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4931/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21122",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:29.126917Z",
            "last_modified_time": "2023-08-16T05:15:29.126937Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "bonukset",
                "sv": "bonusar",
                "en": "bonuses"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21122/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29816",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:55.137885Z",
            "last_modified_time": "2023-08-16T05:15:55.137904Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "boogie woogie (musiikki)",
                "sv": "boogie woogie (musik)",
                "en": "boogie woogie (music)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29816/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39175",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:03.494411Z",
            "last_modified_time": "2023-08-16T05:08:03.494431Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "boogie woogie (tanssit)",
                "sv": "boogie woogie (danser)",
                "en": "boogie-woogie (dances)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39175/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}