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=1203&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=1204&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1202&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p10197",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:04:58.134057Z",
            "last_modified_time": "2023-08-16T05:04:58.134078Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sormieläimet",
                "sv": "fingerdjur",
                "en": "aye-ayes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10197/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p30065",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:44.504186Z",
            "last_modified_time": "2023-08-16T05:07:44.504204Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sormiharjoitukset",
                "sv": "fingerövning",
                "en": "five-finger exercises"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30065/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p30153",
            "has_user_editable_resources": false,
            "alt_labels": [
                "fidget spinnerit",
                "sormispinnerit",
                "spinnerit",
                "fidget spinners",
                "fingersnurror",
                "stressnurror"
            ],
            "created_time": "2023-08-16T05:11:26.490588Z",
            "last_modified_time": "2023-08-16T05:11:26.490608Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sormihyrrät",
                "sv": "fingerspinnare",
                "en": "fidget spinners"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30153/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22492",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:37.614561Z",
            "last_modified_time": "2023-08-16T05:06:37.614580Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sormimaalaus",
                "sv": "fingermålning",
                "en": "finger painting"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22492/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28730",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:32.652109Z",
            "last_modified_time": "2023-08-16T05:07:32.652127Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sormineulonta",
                "sv": "fingerstickning",
                "en": "finger knitting"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28730/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26491",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:43.507559Z",
            "last_modified_time": "2023-08-16T05:15:43.507576Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sorminuket",
                "sv": "fingerdockor",
                "en": "finger puppets"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26491/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26217",
            "has_user_editable_resources": false,
            "alt_labels": [
                "sormiruuat",
                "sormisyötävät",
                "fingermat (maträtter)",
                "plockmat (fingermat)"
            ],
            "created_time": "2023-08-16T05:10:52.721434Z",
            "last_modified_time": "2023-08-16T05:10:52.721454Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sormiruoat",
                "sv": "fingermat (livsmedel)",
                "en": "finger foods"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26217/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26216",
            "has_user_editable_resources": false,
            "alt_labels": [
                "fingermat (bespisning)"
            ],
            "created_time": "2023-08-16T05:07:11.707872Z",
            "last_modified_time": "2023-08-16T05:07:11.707891Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sormiruokailu",
                "sv": "fingermat (måltid)",
                "en": "baby-led weaning"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26216/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24340",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:36.651119Z",
            "last_modified_time": "2023-08-16T05:13:36.651144Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sormitukset",
                "sv": "fingersättningar",
                "en": "fingering"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24340/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38714",
            "has_user_editable_resources": false,
            "alt_labels": [
                "giant ragweed",
                "Ambrosia trifida"
            ],
            "created_time": "2023-08-16T05:07:58.821714Z",
            "last_modified_time": "2023-08-16T05:07:58.821732Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sormituoksukki",
                "sv": "hästambrosia",
                "en": "Ambrosia trifida"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38714/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10788",
            "has_user_editable_resources": false,
            "alt_labels": [
                "fingerringar"
            ],
            "created_time": "2023-08-16T05:05:01.352653Z",
            "last_modified_time": "2023-08-16T05:05:01.352671Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sormukset",
                "sv": "ringar",
                "en": "rings (jewellery)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10788/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16366",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:24.306146Z",
            "last_modified_time": "2023-08-16T05:09:24.306165Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "soroptimistit",
                "sv": "soroptimister",
                "en": "soroptimists"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16366/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13396",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:08.268357Z",
            "last_modified_time": "2023-08-16T05:15:08.268375Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sorptio",
                "sv": "sorption",
                "en": "sorption"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13396/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14859",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:41.819284Z",
            "last_modified_time": "2023-08-16T05:16:41.819309Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sorsalinnut",
                "sv": "andfåglar",
                "en": "anseriformes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14859/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11692",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:48.739705Z",
            "last_modified_time": "2023-08-16T05:08:48.739723Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sorsanputket (suku)",
                "sv": "vattenmärkesläktet",
                "en": "Sium"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11692/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16908",
            "has_user_editable_resources": false,
            "alt_labels": [
                "water parsnip"
            ],
            "created_time": "2023-08-16T05:05:45.824833Z",
            "last_modified_time": "2023-08-16T05:05:45.824856Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sorsanputki (laji)",
                "sv": "vattenmärke",
                "en": "Sium latifolium"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16908/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8345",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Anas",
                "änder"
            ],
            "created_time": "2023-08-16T05:16:24.006178Z",
            "last_modified_time": "2023-08-16T05:16:24.006195Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sorsat (suku)",
                "sv": "Anas",
                "en": "Anas"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8345/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6304",
            "has_user_editable_resources": false,
            "alt_labels": [
                "terrori",
                "terror"
            ],
            "created_time": "2023-08-16T05:18:44.697603Z",
            "last_modified_time": "2023-08-16T05:18:44.697620Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sorto",
                "sv": "förtryck",
                "en": "oppression"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6304/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3245",
            "has_user_editable_resources": false,
            "alt_labels": [
                "routavuodet",
                "sortokaudet",
                "förtrycksperioderna"
            ],
            "created_time": "2023-08-16T05:11:28.387303Z",
            "last_modified_time": "2023-08-16T05:11:28.387322Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sortovuodet",
                "sv": "ofärdsåren",
                "en": "Russification of Finland"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3245/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22523",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:27.825480Z",
            "last_modified_time": "2023-08-16T05:13:27.825499Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sortuminen",
                "sv": "sammanstörtning",
                "en": "collapse"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22523/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}