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=227&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=228&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=226&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p18227",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:39.853845Z",
            "last_modified_time": "2023-08-16T05:09:39.853863Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fotometria",
                "sv": "fotometri",
                "en": "photometry"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18227/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38037",
            "has_user_editable_resources": false,
            "alt_labels": [
                "fotonitiede",
                "valotiede"
            ],
            "created_time": "2023-08-16T05:14:13.495354Z",
            "last_modified_time": "2023-08-16T05:14:13.495375Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fotoniikka",
                "sv": "fotonik",
                "en": "photonics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38037/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2063",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:02.076328Z",
            "last_modified_time": "2023-08-16T05:10:02.076360Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fotonit",
                "sv": "fotoner",
                "en": "photons"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2063/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40244",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2024-01-17T04:40:21.807964Z",
            "last_modified_time": "2024-03-09T04:40:19.127591Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fotopletysmografia",
                "sv": "fotopletysmografi",
                "en": "photoplethysmography"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40244/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17830",
            "has_user_editable_resources": false,
            "alt_labels": [
                "superrealismi",
                "valokuvarealismi",
                "superrealism"
            ],
            "created_time": "2023-08-16T05:09:36.192960Z",
            "last_modified_time": "2023-08-16T05:09:36.192979Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fotorealismi",
                "sv": "fotorealism",
                "en": "photo-realism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17830/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38898",
            "has_user_editable_resources": false,
            "alt_labels": [
                "solar photosphere",
                "fotosfären"
            ],
            "created_time": "2023-08-16T05:14:18.169150Z",
            "last_modified_time": "2023-08-16T05:14:18.169168Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fotosfääri",
                "sv": "fotosfär",
                "en": "photosphere"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38898/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8723",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:16.717042Z",
            "last_modified_time": "2023-08-16T05:12:16.717060Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Fourier'n sarjat",
                "sv": "Fourierserier",
                "en": "Fourier series"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8723/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23372",
            "has_user_editable_resources": false,
            "alt_labels": [
                "foxtrot (dance music)",
                "quicksteps (foxtrots)",
                "foksit (sävellykset)",
                "fokstrotit (sävellykset)",
                "foxit (sävellykset)",
                "foxtrot (tanssimusiikki)",
                "foxtrot (kompositioner)",
                "foxtroter (dansmusik)",
                "foxtrotter (kompositioner)"
            ],
            "created_time": "2023-08-16T05:13:32.290576Z",
            "last_modified_time": "2023-08-16T05:13:32.290593Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "foxtrotit (sävellykset)",
                "sv": "foxtroter (kompositioner)",
                "en": "foxtrots (compositions)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23372/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21763",
            "has_user_editable_resources": false,
            "alt_labels": [
                "foksi (tanssit)",
                "foxtrotit (tanssit)",
                "foxtroter (danser)"
            ],
            "created_time": "2023-08-16T05:15:31.440137Z",
            "last_modified_time": "2023-08-16T05:15:31.440155Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "foxtrot (tanssit)",
                "sv": "foxtrot (danser)",
                "en": "foxtrot (dances)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21763/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5449",
            "has_user_editable_resources": false,
            "alt_labels": [
                "sanontatavat"
            ],
            "created_time": "2023-08-16T05:18:24.374220Z",
            "last_modified_time": "2023-08-16T05:18:24.374237Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fraasit",
                "sv": "fraser",
                "en": "phrases"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5449/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20030",
            "has_user_editable_resources": false,
            "alt_labels": [
                "fraxi-oireyhtymä",
                "särö-X-oireyhtymä",
                "FRAXA-syndrom",
                "fragil X-syndromet",
                "fragil-X-syndrom",
                "fragilt X-syndrom"
            ],
            "created_time": "2023-08-16T05:09:56.764789Z",
            "last_modified_time": "2023-08-16T05:09:56.764814Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fragiili X -oireyhtymä",
                "sv": "fragil X-syndrom",
                "en": "fragile X syndrome"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20030/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18438",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:00.548863Z",
            "last_modified_time": "2023-08-16T05:06:00.548882Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fragmentit",
                "sv": "fragment",
                "en": "fragments"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18438/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6341",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:04.827658Z",
            "last_modified_time": "2023-08-16T05:12:04.827675Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fraktaalit",
                "sv": "fraktaler",
                "en": "fractals"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6341/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40414",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2024-06-20T04:40:22.411191Z",
            "last_modified_time": "2024-08-07T04:40:36.020087Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fraktiointi",
                "sv": "fraktionering (kemi)",
                "en": "fractionation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40414/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2789",
            "has_user_editable_resources": false,
            "alt_labels": [
                "luvake"
            ],
            "created_time": "2023-08-16T05:13:54.913884Z",
            "last_modified_time": "2023-08-16T05:13:54.913904Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "franchising",
                "en": "franchising"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2789/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16278",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:56.826238Z",
            "last_modified_time": "2023-08-16T05:12:56.826309Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Frankfurtin koulukunta",
                "sv": "Frankfurtskolan",
                "en": "Frankfurt School"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16278/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5198",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:17.357675Z",
            "last_modified_time": "2023-08-16T05:08:17.357693Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "frankit",
                "sv": "franker",
                "en": "Franks"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5198/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22057",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:32.289674Z",
            "last_modified_time": "2023-08-16T05:15:32.289692Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "frankofilia",
                "sv": "frankofili",
                "en": "Francophilia"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22057/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26076",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:42.512762Z",
            "last_modified_time": "2023-08-16T05:15:42.512781Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "frankofonia",
                "sv": "frankofoni",
                "en": "francophone"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26076/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6028",
            "has_user_editable_resources": false,
            "alt_labels": [
                "greyfriars",
                "franciskanerorden",
                "franciskanorden"
            ],
            "created_time": "2023-08-16T05:14:35.688560Z",
            "last_modified_time": "2023-08-16T05:14:35.688577Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fransiskaanit",
                "sv": "franciskaner",
                "en": "Franciscans"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6028/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}