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=228&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=229&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=227&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p26714",
            "has_user_editable_resources": false,
            "alt_labels": [
                "fransupitsit",
                "fransspets"
            ],
            "created_time": "2023-08-16T05:07:16.174644Z",
            "last_modified_time": "2023-08-16T05:07:16.174673Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fransut",
                "sv": "fransar",
                "en": "fransut"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26714/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29780",
            "has_user_editable_resources": false,
            "alt_labels": [
                "musical phrasing",
                "frasering (musik)"
            ],
            "created_time": "2023-08-16T05:07:41.946484Z",
            "last_modified_time": "2023-08-16T05:07:41.946501Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fraseeraus",
                "sv": "frasering",
                "en": "phrasing (music)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29780/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22355",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:33.177240Z",
            "last_modified_time": "2023-08-16T05:15:33.177290Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fraseologia",
                "sv": "fraseologi",
                "en": "phraseology"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22355/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22862",
            "has_user_editable_resources": false,
            "alt_labels": [
                "friganism"
            ],
            "created_time": "2023-08-16T05:06:40.764214Z",
            "last_modified_time": "2023-08-16T05:06:40.764233Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "freeganismi",
                "sv": "freeganism",
                "en": "freeganism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22862/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9624",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:35.713587Z",
            "last_modified_time": "2023-08-16T05:08:35.713608Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "FreeHand",
                "en": "FreeHand"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9624/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14255",
            "has_user_editable_resources": false,
            "alt_labels": [
                "free jazz"
            ],
            "created_time": "2023-08-16T05:05:24.041464Z",
            "last_modified_time": "2023-08-16T05:05:24.041491Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "free jazz",
                "sv": "frijazz",
                "en": "free jazz"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14255/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2232",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:17.031234Z",
            "last_modified_time": "2023-08-16T05:10:17.031289Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Freelance Graphics",
                "en": "Freelance Graphics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2232/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2233",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:17.068886Z",
            "last_modified_time": "2023-08-16T05:10:17.068905Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Freelance Plus",
                "en": "Freelance Plus"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2233/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13933",
            "has_user_editable_resources": false,
            "alt_labels": [
                "freelancearbetare",
                "frilansar",
                "frilansare"
            ],
            "created_time": "2023-08-16T05:09:04.942693Z",
            "last_modified_time": "2023-08-16T05:09:04.942709Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "freelance-työntekijät",
                "sv": "frilansarbetare",
                "en": "freelance workers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13933/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12711",
            "has_user_editable_resources": false,
            "alt_labels": [
                "freesior",
                "fresiasläktet"
            ],
            "created_time": "2023-08-16T05:12:37.459375Z",
            "last_modified_time": "2023-08-16T05:12:37.459394Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "freesiat",
                "sv": "freesiasläktet",
                "en": "freesias"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12711/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8086",
            "has_user_editable_resources": false,
            "alt_labels": [
                "hiihtoakrobatia",
                "freestyle (skidåkning)",
                "skidakrobatik"
            ],
            "created_time": "2023-08-16T05:14:46.085922Z",
            "last_modified_time": "2023-08-16T05:14:46.085939Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "freestyle",
                "sv": "freestyle (vintersport)",
                "en": "freestyle skiing"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8086/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38547",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:56.568411Z",
            "last_modified_time": "2023-08-16T05:07:56.568430Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fregatit (purjelaivat)",
                "sv": "fregatter (segelfartyg)",
                "en": "frigates (sailing ships)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38547/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4971",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:58.662446Z",
            "last_modified_time": "2023-08-16T05:11:58.662465Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Freinet-pedagogiikka",
                "sv": "Freinetpedagogik",
                "en": "Freinet pedagogy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4971/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7961",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:45.577787Z",
            "last_modified_time": "2023-08-16T05:14:45.577813Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Freire-pedagogiikka",
                "sv": "Freirepedagogik",
                "en": "Freirean pedagogy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7961/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13953",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:05.187219Z",
            "last_modified_time": "2023-08-16T05:09:05.187238Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "frekvenssit",
                "sv": "frekvenser",
                "en": "frequencies"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13953/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19118",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:25.026560Z",
            "last_modified_time": "2023-08-16T05:15:25.026579Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "frenologia",
                "sv": "frenologi",
                "en": "phrenology"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19118/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1483",
            "has_user_editable_resources": false,
            "alt_labels": [
                "al fresco",
                "freskomålningar"
            ],
            "created_time": "2023-08-16T05:09:11.959653Z",
            "last_modified_time": "2023-08-16T05:09:11.959683Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "freskot",
                "sv": "fresker",
                "en": "frescos"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1483/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3568",
            "has_user_editable_resources": false,
            "alt_labels": [
                "frett"
            ],
            "created_time": "2023-08-16T05:14:10.478370Z",
            "last_modified_time": "2023-08-16T05:14:10.478387Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fretti",
                "sv": "tamiller",
                "en": "ferret"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3568/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8253",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:46.812218Z",
            "last_modified_time": "2023-08-16T05:14:46.812236Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "frigiditeetti",
                "sv": "frigiditet",
                "en": "frigidity"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8253/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19994",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:18.036958Z",
            "last_modified_time": "2023-08-16T05:06:18.036982Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "friisin kieli",
                "sv": "frisiska",
                "en": "Frisian language"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19994/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}