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

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

{
    "meta": {
        "count": 32006,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1179&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1177&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p7654",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:10.882649Z",
            "last_modified_time": "2023-08-16T05:12:10.882665Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "silmälääkärit",
                "sv": "ögonläkare",
                "en": "ophthalmologists"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7654/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23744",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:33.493456Z",
            "last_modified_time": "2023-08-16T05:13:33.493474Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "silmänliikkeet",
                "sv": "ögonrörelser",
                "en": "eye movements"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23744/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24965",
            "has_user_editable_resources": false,
            "alt_labels": [
                "AMD",
                "ARMD",
                "gula fläcken-sjukan"
            ],
            "created_time": "2023-08-16T05:06:59.416013Z",
            "last_modified_time": "2023-08-16T05:06:59.416030Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "silmänpohjan ikärappeuma",
                "sv": "makuladegeneration",
                "en": "macular degeneration"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24965/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p37824",
            "has_user_editable_resources": false,
            "alt_labels": [
                "ripset"
            ],
            "created_time": "2023-08-16T05:14:11.797411Z",
            "last_modified_time": "2023-08-16T05:14:11.797430Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "silmäripset",
                "sv": "ögonfransar",
                "en": "eyelashes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p37824/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18324",
            "has_user_editable_resources": false,
            "alt_labels": [
                "ögonen"
            ],
            "created_time": "2023-08-16T05:19:02.134742Z",
            "last_modified_time": "2023-08-16T05:19:02.134766Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "silmät",
                "sv": "ögon",
                "en": "eyes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18324/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12047",
            "has_user_editable_resources": false,
            "alt_labels": [
                "silmäsairaudet"
            ],
            "created_time": "2023-08-16T05:19:35.962369Z",
            "last_modified_time": "2023-08-16T05:19:35.962387Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "silmätaudit",
                "sv": "ögonsjukdomar",
                "en": "eye diseases"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12047/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7287",
            "has_user_editable_resources": false,
            "alt_labels": [
                "oftalmologia"
            ],
            "created_time": "2023-08-16T05:08:25.398177Z",
            "last_modified_time": "2023-08-16T05:08:25.398194Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "silmätautioppi",
                "sv": "oftalmologi",
                "en": "ophthalmology"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7287/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26170",
            "has_user_editable_resources": false,
            "alt_labels": [
                "hudsvampsjukdom"
            ],
            "created_time": "2023-08-16T05:13:45.665802Z",
            "last_modified_time": "2023-08-16T05:13:45.665820Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "silsa",
                "sv": "dermatofytos",
                "en": "tinea"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26170/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7739",
            "has_user_editable_resources": false,
            "alt_labels": [
                "siluetter"
            ],
            "created_time": "2023-08-16T05:08:26.963973Z",
            "last_modified_time": "2023-08-16T05:08:26.963993Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "siluetit",
                "sv": "silhuetter",
                "en": "silhouettes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7739/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p37775",
            "has_user_editable_resources": false,
            "alt_labels": [
                "gotlandium"
            ],
            "created_time": "2023-08-16T05:07:49.446190Z",
            "last_modified_time": "2023-08-16T05:07:49.446210Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "siluurikausi",
                "sv": "silur",
                "en": "Silurian"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p37775/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14075",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:22.454496Z",
            "last_modified_time": "2023-08-16T05:05:22.454515Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Silva-menetelmä",
                "sv": "Silvametoden",
                "en": "Silva method"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14075/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3874",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:59.119178Z",
            "last_modified_time": "2023-08-16T05:07:59.119205Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Silvia vero",
                "en": "Silvia vero"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3874/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27822",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:25.269779Z",
            "last_modified_time": "2023-08-16T05:07:25.269796Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sima",
                "sv": "mjöd",
                "en": "mead (non-alcoholic)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27822/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40188",
            "has_user_editable_resources": false,
            "alt_labels": [
                "SIM-kort",
                "simkort",
                "eSIM-kortit",
                "eSIM-kort",
                "eSIM cards"
            ],
            "created_time": "2023-10-25T04:40:14.974704Z",
            "last_modified_time": "2023-11-18T04:40:55.733915Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "SIM-kortit",
                "sv": "sim-kort",
                "en": "SIM cards"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40188/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8761",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Pan troglodytes"
            ],
            "created_time": "2023-08-16T05:08:31.515320Z",
            "last_modified_time": "2023-08-16T05:08:31.515339Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "simpanssi (laji)",
                "sv": "schimpans (art)",
                "en": "chimpanzee"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8761/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38183",
            "has_user_editable_resources": false,
            "alt_labels": [
                "chimpansees (genus)",
                "Pan"
            ],
            "created_time": "2023-08-16T05:11:35.060105Z",
            "last_modified_time": "2023-08-16T05:11:35.060130Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "simpanssit (suku)",
                "sv": "schimpanser (släkte)",
                "en": "Pan (hominids)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38183/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19465",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Scorpaeniformes"
            ],
            "created_time": "2023-08-16T05:09:51.400234Z",
            "last_modified_time": "2023-09-17T04:40:12.707043Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "simppukalat",
                "sv": "kindpansrade fiskar",
                "en": "Scorpaeniformes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19465/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1480",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:50.209058Z",
            "last_modified_time": "2023-08-16T05:18:50.209080Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "simpukat",
                "sv": "musslor",
                "en": "bivalvia"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1480/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19694",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:53.562592Z",
            "last_modified_time": "2023-08-16T05:09:53.562611Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "simput",
                "sv": "simpor",
                "en": "Cottidae"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19694/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p68",
            "has_user_editable_resources": false,
            "alt_labels": [
                "pennalismi"
            ],
            "created_time": "2023-08-16T05:17:18.488672Z",
            "last_modified_time": "2023-08-16T05:17:18.488690Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "simputus",
                "sv": "pennalism",
                "en": "bullying (military)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p68/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}