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

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

{
    "meta": {
        "count": 31675,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=36&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=34&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p26063",
            "has_user_editable_resources": false,
            "alt_labels": [
                "akkadisk litteratur"
            ],
            "created_time": "2023-08-16T05:10:51.614724Z",
            "last_modified_time": "2023-08-16T05:10:51.614749Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "akkadinkielinen kirjallisuus",
                "sv": "litteratur på akkadiska",
                "en": "Akkadian language literature"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26063/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25030",
            "has_user_editable_resources": false,
            "alt_labels": [
                "akklimaatio",
                "akklimointi",
                "ilmastoon sopeutuminen"
            ],
            "created_time": "2023-08-16T05:15:40.013688Z",
            "last_modified_time": "2023-08-16T05:15:40.013704Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "akklimatisaatio",
                "sv": "acklimatisering",
                "en": "acclimation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25030/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5622",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:14.963723Z",
            "last_modified_time": "2023-08-16T05:17:14.963742Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "akkreditointi",
                "sv": "ackreditering",
                "en": "accreditation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5622/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7905",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:46.195150Z",
            "last_modified_time": "2023-08-16T05:18:46.195182Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "akkulturaatio",
                "sv": "ackulturation",
                "en": "acculturation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7905/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14689",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:26.911628Z",
            "last_modified_time": "2023-08-16T05:05:26.911646Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "akkusatiivi",
                "sv": "ackusativ",
                "en": "accusative case"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14689/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10224",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:39.278421Z",
            "last_modified_time": "2023-08-16T05:08:39.278441Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "A-klinikat",
                "sv": "A-kliniker",
                "en": "A-clinics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10224/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25801",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:48.994379Z",
            "last_modified_time": "2023-08-16T05:10:48.994399Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "akmeismi",
                "sv": "akmeism",
                "en": "Acmeism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25801/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27105",
            "has_user_editable_resources": false,
            "alt_labels": [
                "acne"
            ],
            "created_time": "2023-08-16T05:07:19.831701Z",
            "last_modified_time": "2023-08-16T05:07:19.831723Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "akne",
                "en": "acne"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27105/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8057",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:12.747476Z",
            "last_modified_time": "2023-08-16T05:12:12.747495Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "akrobaatit",
                "sv": "akrobater",
                "en": "acrobats"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8057/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1277",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:09.981531Z",
            "last_modified_time": "2023-08-16T05:18:09.981549Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "akrobatia",
                "sv": "akrobatik",
                "en": "acrobatics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1277/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40107",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-23T04:40:44.242647Z",
            "last_modified_time": "2023-10-26T04:40:22.079510Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "akromegalia",
                "sv": "akromegali",
                "en": "acromegaly"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40107/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27873",
            "has_user_editable_resources": false,
            "alt_labels": [
                "akrostismi",
                "akrostikoner"
            ],
            "created_time": "2023-08-16T05:07:25.599151Z",
            "last_modified_time": "2023-08-16T05:07:25.599171Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "akrostikonit",
                "sv": "akrostikon",
                "en": "acrostics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27873/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4983",
            "has_user_editable_resources": false,
            "alt_labels": [
                "acrylic",
                "polymetyylimetakrylaatti",
                "akrylplast",
                "polymetylmetakrylat"
            ],
            "created_time": "2023-08-16T05:08:16.305130Z",
            "last_modified_time": "2023-08-16T05:08:16.305156Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "akryyli",
                "sv": "akryl",
                "en": "acryl"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4983/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20964",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:27.409171Z",
            "last_modified_time": "2023-08-16T05:06:27.409188Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "akryyliamidi",
                "sv": "akrylamid",
                "en": "acrylamide"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20964/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15472",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:17.095405Z",
            "last_modified_time": "2023-08-16T05:09:17.095426Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "akryylimaalaus",
                "sv": "akrylmålning",
                "en": "acrylic painting"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15472/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11143",
            "has_user_editable_resources": false,
            "alt_labels": [
                "akrylonitriili",
                "akrylonitril"
            ],
            "created_time": "2023-08-16T05:05:03.218963Z",
            "last_modified_time": "2023-08-16T05:05:03.218982Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "akryylinitriili",
                "sv": "akrylnitril",
                "en": "acrylonitrile"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11143/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16755",
            "has_user_editable_resources": false,
            "alt_labels": [
                "axlar (maskindelar)"
            ],
            "created_time": "2023-08-16T05:05:44.234330Z",
            "last_modified_time": "2023-08-16T05:05:44.234350Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "akselit",
                "sv": "axlar (maskinkomponenter)",
                "en": "shafts (machine components)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16755/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25475",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:41.084469Z",
            "last_modified_time": "2023-08-16T05:15:41.084488Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "akselivallat",
                "sv": "axelmakterna",
                "en": "Axis powers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25475/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26811",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:48.696522Z",
            "last_modified_time": "2023-08-16T05:13:48.696541Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aksentti",
                "sv": "accent",
                "en": "accent (linguistics)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26811/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15253",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:15.228034Z",
            "last_modified_time": "2023-08-16T05:09:15.228052Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aksioomat",
                "sv": "axiom",
                "en": "axioms"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15253/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}