GET

Keyword List List

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

{
    "meta": {
        "count": 31758,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=224&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=222&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p25656",
            "has_user_editable_resources": false,
            "alt_labels": [
                "flash-minnen"
            ],
            "created_time": "2023-08-16T05:10:47.677692Z",
            "last_modified_time": "2023-08-16T05:10:47.677709Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "flash-muistit",
                "sv": "flashminnen",
                "en": "flash memories"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25656/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39951",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:25.188461Z",
            "last_modified_time": "2023-08-16T05:14:25.188480Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "flavivirukset",
                "sv": "flavivirus",
                "en": "flaviviruses"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39951/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28043",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:48.630743Z",
            "last_modified_time": "2023-08-16T05:15:48.630770Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "flavivirusinfektiot",
                "sv": "flavivirusinfektioner",
                "en": "flavivirus infections"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28043/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6771",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:26.149751Z",
            "last_modified_time": "2023-08-16T05:18:26.149767Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "flavonoidit",
                "sv": "flavonoider",
                "en": "flavonoids"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6771/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23638",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:30.152462Z",
            "last_modified_time": "2023-08-16T05:10:30.152488Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "flavonolit",
                "sv": "flavonoler",
                "en": "flavonols"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23638/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22991",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:23.809041Z",
            "last_modified_time": "2023-08-16T05:10:23.809059Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Fle3",
                "en": "Fle3"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22991/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16751",
            "has_user_editable_resources": false,
            "alt_labels": [
                "venography",
                "laskimoiden varjoainekuvaus",
                "laskimoiden varjoainetutkimus",
                "venografia",
                "venografi"
            ],
            "created_time": "2023-08-16T05:05:44.175740Z",
            "last_modified_time": "2023-08-16T05:05:44.175765Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "flebografia",
                "sv": "flebografi",
                "en": "phlebography"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16751/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21424",
            "has_user_editable_resources": false,
            "alt_labels": [
                "fliis",
                "fliisi"
            ],
            "created_time": "2023-08-16T05:06:30.071302Z",
            "last_modified_time": "2023-08-16T05:06:30.071322Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fleece",
                "en": "fleece"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21424/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22442",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:37.154650Z",
            "last_modified_time": "2023-08-16T05:06:37.154670Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "flekainidi",
                "sv": "flekainid",
                "en": "flecainide"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22442/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38652",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:16.608323Z",
            "last_modified_time": "2023-08-16T05:14:16.608342Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Flickr",
                "en": "Flickr"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38652/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13570",
            "has_user_editable_resources": false,
            "alt_labels": [
                "flirttailu"
            ],
            "created_time": "2023-08-16T05:15:08.896753Z",
            "last_modified_time": "2023-08-16T05:15:08.896782Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "flirtti",
                "sv": "flirt",
                "en": "flirting"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13570/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22058",
            "has_user_editable_resources": false,
            "alt_labels": [
                "floristinen kasvimaantiede",
                "floristisk växtgeografi"
            ],
            "created_time": "2023-08-16T05:10:14.160677Z",
            "last_modified_time": "2023-10-19T06:50:30.696413Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "floristiikka (kasvitiede)",
                "sv": "floristik (botanik)",
                "en": "floristics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22058/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12562",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:49.555071Z",
            "last_modified_time": "2023-08-16T05:18:49.555090Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "floristit",
                "sv": "florister",
                "en": "qualification in floristry"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12562/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24415",
            "has_user_editable_resources": false,
            "alt_labels": [
                "flow-kokemus",
                "virtauskokemus",
                "flow",
                "flowupplevelse"
            ],
            "created_time": "2023-08-16T05:13:36.999374Z",
            "last_modified_time": "2023-08-16T05:13:36.999393Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "flow-tila",
                "sv": "flowtillstånd",
                "en": "flow (experiences)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24415/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27299",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:17.229006Z",
            "last_modified_time": "2023-08-16T05:18:17.229024Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fluidit",
                "sv": "fluider",
                "en": "fluids"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27299/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26768",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:48.479618Z",
            "last_modified_time": "2023-08-16T05:13:48.479644Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fluoksetiini",
                "sv": "fluoxetin",
                "en": "fluoxetine"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26768/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20496",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:00.984327Z",
            "last_modified_time": "2023-08-16T05:10:00.984356Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fluoraus",
                "sv": "fluoridering",
                "en": "fluoridation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20496/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3265",
            "has_user_editable_resources": false,
            "alt_labels": [
                "fluoriloiste"
            ],
            "created_time": "2023-08-16T05:07:46.945976Z",
            "last_modified_time": "2023-08-16T05:07:46.946015Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fluoresenssi",
                "sv": "fluorescens",
                "en": "fluorescence"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3265/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27588",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:53.278595Z",
            "last_modified_time": "2023-08-16T05:13:53.278617Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fluoresenssimikroskopia",
                "sv": "fluorescensmikroskopi",
                "en": "fluorescence microscopy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27588/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16439",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:41.395682Z",
            "last_modified_time": "2023-08-16T05:05:41.395700Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fluori",
                "sv": "fluor",
                "en": "fluorine"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16439/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}