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

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

{
    "meta": {
        "count": 31805,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=265&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=263&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p13684",
            "has_user_editable_resources": false,
            "alt_labels": [
                "hapatus",
                "syrande"
            ],
            "created_time": "2023-08-16T05:18:34.184427Z",
            "last_modified_time": "2023-08-16T05:18:34.184447Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "hapattaminen",
                "sv": "syrning",
                "en": "souring"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13684/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21083",
            "has_user_editable_resources": false,
            "alt_labels": [
                "acidifiers"
            ],
            "created_time": "2023-08-16T05:10:05.267804Z",
            "last_modified_time": "2023-08-16T05:10:05.267822Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "hapatteet",
                "sv": "syrningsmedel",
                "en": "acidifying agents"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21083/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25455",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:42.052524Z",
            "last_modified_time": "2023-08-16T05:13:42.052541Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "hapenotto",
                "sv": "syreupptagning",
                "en": "oxygen uptake"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25455/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19161",
            "has_user_editable_resources": false,
            "alt_labels": [
                "asfyxi",
                "asphyxia",
                "asfyksia",
                "anoksia (elimistö)",
                "hypoksia (elimistö)",
                "anoxi (medicin)",
                "hypoxi (medicin)",
                "anoxemia",
                "anoxia",
                "hypoxia (body)",
                "lack of oxygen (medicine)"
            ],
            "created_time": "2023-08-16T05:16:47.369865Z",
            "last_modified_time": "2024-10-05T04:41:42.668820Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "hapenpuute (elimistö)",
                "sv": "syrebrist (kroppen)",
                "en": "lack of oxygen (physiology)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19161/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19945",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:14.364411Z",
            "last_modified_time": "2023-08-16T05:13:14.364428Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "haperot",
                "sv": "kremlor",
                "en": "Russula"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19945/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9119",
            "has_user_editable_resources": false,
            "alt_labels": [
                "becoming oxidised",
                "becoming oxidized"
            ],
            "created_time": "2023-08-16T05:18:29.881446Z",
            "last_modified_time": "2023-08-16T05:18:29.881466Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "hapettuminen",
                "sv": "oxidation",
                "en": "oxidation (passive)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9119/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9135",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:29.988493Z",
            "last_modified_time": "2023-08-16T05:18:29.988521Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "hapetus",
                "sv": "oxidering",
                "en": "oxidation (active)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9135/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28877",
            "has_user_editable_resources": false,
            "alt_labels": [
                "redox reaction"
            ],
            "created_time": "2023-08-16T05:17:47.693476Z",
            "last_modified_time": "2023-08-16T05:17:47.693495Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "hapetus-pelkistysreaktio",
                "sv": "redoxreaktion",
                "en": "oxidation-reduction reaction"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28877/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40530",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2024-11-02T04:41:41.376786Z",
            "last_modified_time": "2024-11-15T04:41:40.666726Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "haploryhmät",
                "sv": "haplogrupper",
                "en": "haplogroups"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40530/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15605",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:34.398571Z",
            "last_modified_time": "2023-08-16T05:05:34.398588Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "haponkestävä teräs",
                "sv": "syrafast stål",
                "en": "acid-proof steel"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15605/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6514",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:19:32.345575Z",
            "last_modified_time": "2023-08-16T05:19:32.345667Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "hapot",
                "sv": "syror",
                "en": "acids"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6514/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p584",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:57.680545Z",
            "last_modified_time": "2023-08-16T05:17:57.680564Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "happamoituminen",
                "sv": "försurning",
                "en": "acidification"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p584/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4554",
            "has_user_editable_resources": false,
            "alt_labels": [
                "surhetsgrad",
                "aciditet"
            ],
            "created_time": "2023-08-16T05:18:55.815820Z",
            "last_modified_time": "2023-09-24T04:40:51.128626Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "happamuus (kemia)",
                "sv": "surhet (kemi)",
                "en": "acidity"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4554/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40167",
            "has_user_editable_resources": false,
            "alt_labels": [
                "syrlighet (smak)",
                "sour taste",
                "hapan maku",
                "sur smak",
                "syrlig smak"
            ],
            "created_time": "2023-09-17T04:40:30.102523Z",
            "last_modified_time": "2023-10-27T04:41:12.413703Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "happamuus (maku)",
                "sv": "surhet (smak)",
                "en": "sourness (taste)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40167/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2112",
            "has_user_editable_resources": false,
            "alt_labels": [
                "happenings"
            ],
            "created_time": "2023-08-16T05:13:20.171451Z",
            "last_modified_time": "2023-08-16T05:13:20.171467Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "happeningit",
                "sv": "happeningar",
                "en": "happenings"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2112/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11518",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:31.409375Z",
            "last_modified_time": "2023-08-16T05:12:31.409427Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "happi",
                "sv": "syre",
                "en": "oxygen"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11518/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6474",
            "has_user_editable_resources": false,
            "alt_labels": [
                "luftterapi",
                "oxygenbehandling"
            ],
            "created_time": "2023-08-16T05:08:21.973189Z",
            "last_modified_time": "2023-08-16T05:08:21.973206Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "happihoito",
                "sv": "syrgasbehandling",
                "en": "oxygen therapy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6474/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11510",
            "has_user_editable_resources": false,
            "alt_labels": [
                "asfyxi",
                "anoxi (vatten)",
                "hypoxi (vatten)",
                "syresvinn",
                "anoksia (vesistöt)",
                "hapenpuute (vesistöt)",
                "hypoksia (vesistöt)"
            ],
            "created_time": "2023-08-16T05:16:34.243242Z",
            "last_modified_time": "2024-05-07T04:41:29.128797Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "happikato",
                "sv": "syrebrist (vatten)",
                "en": "oxygen depletion"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11510/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38822",
            "has_user_editable_resources": false,
            "alt_labels": [
                "oxy-fuel combustion"
            ],
            "created_time": "2023-08-16T05:11:41.828205Z",
            "last_modified_time": "2023-08-16T05:11:41.828222Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "happipoltto",
                "sv": "syrgasförbränning",
                "en": "oxy-combustion"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38822/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22958",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:30.278928Z",
            "last_modified_time": "2023-08-16T05:13:30.278946Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "happiradikaalit",
                "sv": "syreradikaler",
                "en": "oxygen radicals"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22958/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}