Keyword List List – Django REST framework

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=21&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=22&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=20&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p24834",
            "has_user_editable_resources": false,
            "alt_labels": [
                "ilmakehän ekologia"
            ],
            "created_time": "2023-08-16T05:10:40.010456Z",
            "last_modified_time": "2023-08-16T05:10:40.010477Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aeroekologia",
                "sv": "aeroekologi",
                "en": "aeroecology"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24834/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38027",
            "has_user_editable_resources": false,
            "alt_labels": [
                "aerogel"
            ],
            "created_time": "2023-08-16T05:11:33.624194Z",
            "last_modified_time": "2023-08-16T05:11:33.624223Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aerogeelit",
                "sv": "aerogeler",
                "en": "aerogels"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38027/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23553",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:29.220581Z",
            "last_modified_time": "2023-08-16T05:10:29.220599Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aerogeofysiikka",
                "sv": "flyggeofysik",
                "en": "aerogeophysics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23553/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5392",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:00.492290Z",
            "last_modified_time": "2023-08-16T05:12:00.492309Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aerologia",
                "sv": "aerologi",
                "en": "aerology"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5392/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3384",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:09.759483Z",
            "last_modified_time": "2023-08-16T05:14:09.759502Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aeromekaniikka",
                "sv": "aeromekanik",
                "en": "aeromechanics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3384/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7133",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:08.395999Z",
            "last_modified_time": "2023-08-16T05:12:08.396017Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aeronomia",
                "sv": "aeronomi",
                "en": "aeronomy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7133/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15192",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:30.862755Z",
            "last_modified_time": "2023-08-16T05:05:30.862774Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aerosolifysiikka",
                "sv": "aerosolfysik",
                "en": "aerosol physics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15192/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16132",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:39.038764Z",
            "last_modified_time": "2023-08-16T05:05:39.038790Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aerosolipakkaukset",
                "sv": "aerosolförpackningar",
                "en": "aerosol packages"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16132/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9802",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:29.425063Z",
            "last_modified_time": "2023-08-16T05:16:29.425083Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aerosolit",
                "sv": "aerosoler",
                "en": "aerosols"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9802/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3383",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:29.088615Z",
            "last_modified_time": "2023-08-16T05:11:29.088635Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aerostatiikka",
                "sv": "aerostatik",
                "en": "aerostatics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3383/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38727",
            "has_user_editable_resources": false,
            "alt_labels": [
                "afariska"
            ],
            "created_time": "2023-08-16T05:07:58.896762Z",
            "last_modified_time": "2023-08-16T05:07:58.896783Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "afarin kieli",
                "sv": "afar (språk)",
                "en": "Afar language"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38727/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13492",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:39.019227Z",
            "last_modified_time": "2023-08-16T05:16:39.019251Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "afasia",
                "sv": "afasi",
                "en": "aphasia"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13492/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11268",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:30.057661Z",
            "last_modified_time": "2023-08-16T05:12:30.057679Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "affektiivisuus",
                "sv": "affektivitet",
                "en": "affectivity"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11268/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25312",
            "has_user_editable_resources": false,
            "alt_labels": [
                "apinapinseri"
            ],
            "created_time": "2023-08-16T05:10:44.361688Z",
            "last_modified_time": "2023-08-16T05:10:44.361708Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "affenpinseri",
                "sv": "affenpinscher",
                "en": "affenpinscher"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25312/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2836",
            "has_user_editable_resources": false,
            "alt_labels": [
                "liitteet (kielitiede)"
            ],
            "created_time": "2023-08-16T05:13:58.004602Z",
            "last_modified_time": "2023-08-16T05:13:58.004620Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "affiksit",
                "sv": "affix",
                "en": "affixes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2836/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22414",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:17.910245Z",
            "last_modified_time": "2023-08-16T05:10:17.910335Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "afgaaninvinttikoira",
                "sv": "afghanhund",
                "en": "Afghan hound"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22414/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22518",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:37.935921Z",
            "last_modified_time": "2023-08-16T05:06:37.935948Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "afganistanilaiset",
                "sv": "afghaner",
                "en": "Afghans"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22518/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16274",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Afghanistankriget",
                "Afghansk-sovjetiska kriget"
            ],
            "created_time": "2023-08-16T05:12:56.714998Z",
            "last_modified_time": "2023-08-16T05:12:56.715017Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Afganistanin sota (1979-1989)",
                "sv": "Afghanistankriget 1979-1989",
                "en": "Soviet–Afghan War (1979-1989)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16274/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27437",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Afghanistankriget"
            ],
            "created_time": "2023-08-16T05:13:52.402624Z",
            "last_modified_time": "2023-08-16T05:13:52.402651Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Afganistanin sota (2001-2021)",
                "sv": "Afghanistankriget (2001-2021)",
                "en": "War in Afghanistan (2001-2021)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27437/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23018",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:34.853890Z",
            "last_modified_time": "2023-08-16T05:15:34.853907Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aflatoksiinit",
                "sv": "aflatoxiner",
                "en": "aflatoxins"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23018/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}