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

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

{
    "meta": {
        "count": 31685,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1458&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1456&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p16549",
            "has_user_editable_resources": false,
            "alt_labels": [
                "peritoniitti",
                "vatsakalvotulehdus"
            ],
            "created_time": "2023-08-16T05:05:42.430302Z",
            "last_modified_time": "2023-08-16T05:05:42.430321Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "vatsakalvontulehdus",
                "sv": "bukhinneinflammation",
                "en": "peritonitis"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16549/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39348",
            "has_user_editable_resources": false,
            "alt_labels": [
                "vatsanseinämä"
            ],
            "created_time": "2023-08-16T05:08:05.107757Z",
            "last_modified_time": "2023-08-16T05:08:05.107776Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "vatsanpeitteet",
                "sv": "bukvägg",
                "en": "abdominal wall"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39348/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25175",
            "has_user_editable_resources": false,
            "alt_labels": [
                "bukhålan"
            ],
            "created_time": "2023-08-16T05:07:00.806275Z",
            "last_modified_time": "2023-08-16T05:07:00.806294Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "vatsaontelo",
                "sv": "bukhåla",
                "en": "abdominal cavity"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25175/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19025",
            "has_user_editable_resources": false,
            "alt_labels": [
                "laparoskopia"
            ],
            "created_time": "2023-08-16T05:06:07.312341Z",
            "last_modified_time": "2023-08-16T05:06:07.312359Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "vatsaontelontähystys",
                "sv": "laparoskopi",
                "en": "laparoscopy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19025/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38279",
            "has_user_editable_resources": false,
            "alt_labels": [
                "ventrilokvismi",
                "ventrilokvism"
            ],
            "created_time": "2023-08-16T05:07:53.539836Z",
            "last_modified_time": "2023-08-16T05:07:53.539854Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "vatsastapuhuminen",
                "sv": "buktaleri",
                "en": "ventriloquism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38279/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12293",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Fattighuset i Uleåborg"
            ],
            "created_time": "2023-08-16T05:12:35.674578Z",
            "last_modified_time": "2023-08-16T05:12:35.674596Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Vattihuusi",
                "en": "Vattihuusi"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12293/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14468",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Rubus"
            ],
            "created_time": "2023-08-16T05:16:40.911514Z",
            "last_modified_time": "2023-08-16T05:16:40.911539Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "vatukat",
                "sv": "hallonsläktet",
                "en": "Rubus"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14468/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7156",
            "has_user_editable_resources": false,
            "alt_labels": [
                "vaudeviller",
                "vådevill"
            ],
            "created_time": "2023-08-16T05:18:26.853674Z",
            "last_modified_time": "2023-08-16T05:18:26.853691Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "vaudeville",
                "en": "vaudeville"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7156/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21345",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:41.557576Z",
            "last_modified_time": "2023-08-16T05:17:41.557594Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "vaunut",
                "sv": "vagnar",
                "en": "carriages"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21345/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21816",
            "has_user_editable_resources": false,
            "alt_labels": [
                "babymassage"
            ],
            "created_time": "2023-08-16T05:06:32.994029Z",
            "last_modified_time": "2023-08-16T05:06:32.994054Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "vauvahieronta",
                "sv": "babymassage",
                "en": "baby massage"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21816/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26180",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:52.389319Z",
            "last_modified_time": "2023-08-16T05:10:52.389338Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "vauvalehdet",
                "sv": "babytidningar",
                "en": "baby magazines"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26180/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39435",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:06.163969Z",
            "last_modified_time": "2023-08-16T05:08:06.163986Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "vauvanuket",
                "sv": "babydockor",
                "en": "baby dolls"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39435/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26479",
            "has_user_editable_resources": false,
            "alt_labels": [
                "spädbarnskläder"
            ],
            "created_time": "2023-08-16T05:07:14.525135Z",
            "last_modified_time": "2023-08-16T05:07:14.525155Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "vauvanvaatteet",
                "sv": "babykläder",
                "en": "baby clothes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26479/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5200",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:59.405348Z",
            "last_modified_time": "2023-08-16T05:11:59.405366Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "vauvauinti",
                "sv": "babysim",
                "en": "infant swimming"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5200/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28749",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:12.942563Z",
            "last_modified_time": "2023-08-16T05:11:12.942581Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "vavat",
                "sv": "spön",
                "en": "fishing rods"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28749/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13970",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:21.584963Z",
            "last_modified_time": "2023-08-16T05:05:21.584982Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "VaxTerm",
                "en": "VaxTerm"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13970/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6654",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:22.754472Z",
            "last_modified_time": "2023-08-16T05:08:22.754491Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "VDE",
                "en": "VDE"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6654/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11554",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:05.562938Z",
            "last_modified_time": "2023-08-16T05:05:05.562969Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Veda",
                "en": "Veda"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11554/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8361",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:29.807384Z",
            "last_modified_time": "2023-08-16T05:08:29.807403Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "vedanta",
                "en": "vedanta"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8361/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10318",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:04:59.043461Z",
            "last_modified_time": "2023-08-16T05:04:59.043482Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "veda-uskonto",
                "sv": "vedisk religion",
                "en": "Vedic religion"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10318/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}