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=158&show_all_keywords=True

HTTP 200 OK
Allow: GET, POST, HEAD, OPTIONS
Content-Type: application/json ;utf-8
Vary: Accept

{
    "meta": {
        "count": 31927,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=159&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=157&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p9666",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:30.891727Z",
            "last_modified_time": "2023-08-16T05:18:30.891745Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dynastiat",
                "sv": "dynastier",
                "en": "dynasties"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9666/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5303",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:00.101570Z",
            "last_modified_time": "2023-08-16T05:12:00.101589Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dysleksia",
                "sv": "dyslexi",
                "en": "dyslexia"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5303/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22417",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:17.985579Z",
            "last_modified_time": "2023-08-16T05:10:17.985596Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dyslipidemia",
                "sv": "dyslipidemi",
                "en": "dyslipidemia"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22417/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21151",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:28.603823Z",
            "last_modified_time": "2023-08-16T05:06:28.603843Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dysmelia",
                "sv": "dysmeli",
                "en": "dysmelia"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21151/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13786",
            "has_user_editable_resources": false,
            "alt_labels": [
                "indigestion"
            ],
            "created_time": "2023-08-16T05:05:20.223194Z",
            "last_modified_time": "2023-08-16T05:05:20.223212Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dyspepsia",
                "sv": "dyspepsi",
                "en": "dyspepsia"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13786/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26382",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:44.671488Z",
            "last_modified_time": "2023-08-16T05:17:44.671518Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dysplasiat",
                "sv": "dysplasier",
                "en": "dysplasia"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26382/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22742",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:39.814126Z",
            "last_modified_time": "2023-08-16T05:06:39.814144Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dyspraksia",
                "sv": "dyspraxi",
                "en": "dyspraxia"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22742/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38603",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:39.318844Z",
            "last_modified_time": "2023-08-16T05:11:39.318862Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dysprosium",
                "en": "dysprosium"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38603/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17936",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:37.201136Z",
            "last_modified_time": "2023-08-16T05:09:37.201154Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Düsseldorfin koulukunta",
                "sv": "Düsseldorfskolan",
                "en": "Düsseldorf school of painting"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17936/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18132",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:57.534723Z",
            "last_modified_time": "2023-08-16T05:05:57.534740Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dystonia",
                "sv": "dystoni",
                "en": "dystonia"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18132/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20646",
            "has_user_editable_resources": false,
            "alt_labels": [
                "antiutopiat",
                "antiutopier"
            ],
            "created_time": "2023-08-16T05:15:27.448622Z",
            "last_modified_time": "2023-08-16T05:15:27.448640Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dystopiat",
                "sv": "dystopier",
                "en": "dystopias"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20646/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4313",
            "has_user_editable_resources": false,
            "alt_labels": [
                "lentohietikot",
                "flygsandsfält"
            ],
            "created_time": "2023-08-16T05:11:55.605913Z",
            "last_modified_time": "2023-08-16T05:11:55.605934Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dyynit",
                "sv": "dyner",
                "en": "dunes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4313/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17084",
            "has_user_editable_resources": false,
            "alt_labels": [
                "E80-esikoiskirjailijaseminaari",
                "E80-esikoiskirjailijatapaaminen",
                "Eurooppa 80 -kirjailijatapaaminen",
                "E80-kirjailijatapaaminen (författarmöte)"
            ],
            "created_time": "2023-08-16T05:13:01.132085Z",
            "last_modified_time": "2023-08-16T05:13:01.132103Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "E80-kirjailijatapaaminen",
                "en": "E80-kirjailijatapaaminen"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17084/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23506",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:47.475666Z",
            "last_modified_time": "2023-08-16T05:06:47.475697Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Easy Adobe Premiere Elements",
                "en": "Easy Adobe Premiere Elements"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23506/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39449",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Ebionism",
                "ebioniitit",
                "ebionilaiset",
                "ebioniter",
                "ebjoniter"
            ],
            "created_time": "2023-08-16T05:08:06.330088Z",
            "last_modified_time": "2023-08-16T05:08:06.330106Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ebionit",
                "sv": "evjoniter",
                "en": "Ebionites"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39449/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40034",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Ebola fever",
                "Ebola virus disease",
                "ebola",
                "ebolakuume",
                "ebolafeber",
                "ebolavirussjukdom"
            ],
            "created_time": "2023-08-16T05:11:53.714529Z",
            "last_modified_time": "2023-08-16T05:11:53.714548Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ebolatauti",
                "sv": "ebola (sjukdom)",
                "en": "Ebola hemorrhagic fever"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40034/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40052",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Ebolavirus",
                "ebola (virus)"
            ],
            "created_time": "2023-08-16T05:14:25.682652Z",
            "last_modified_time": "2023-08-16T05:14:25.682679Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ebolavirukset",
                "sv": "ebolavirus",
                "en": "ebolaviruses"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40052/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23308",
            "has_user_editable_resources": false,
            "alt_labels": [
                "echovirukset",
                "enteric human cytopathogenic orphan viruses"
            ],
            "created_time": "2023-08-16T05:10:26.766253Z",
            "last_modified_time": "2023-08-16T05:10:26.766316Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ECHO-virukset",
                "sv": "echovirus",
                "en": "ECHO viruses"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23308/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5407",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:12.914809Z",
            "last_modified_time": "2023-08-16T05:16:12.914829Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "eContent-ohjelma",
                "sv": "eContent-programmet",
                "en": "eContent Programme"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5407/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39390",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Edam",
                "edam",
                "edamer",
                "edamost"
            ],
            "created_time": "2023-08-16T05:08:05.580786Z",
            "last_modified_time": "2023-08-16T05:08:05.580804Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "edamjuusto",
                "sv": "edamerost",
                "en": "Edam cheese"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39390/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}