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=140&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=141&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=139&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p12512",
            "has_user_editable_resources": false,
            "alt_labels": [
                "jäätikön vetäytyminen"
            ],
            "created_time": "2023-08-16T05:17:33.173657Z",
            "last_modified_time": "2023-08-16T05:17:33.173674Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "deglasiaatio",
                "sv": "deglaciation",
                "en": "deglaciation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12512/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25991",
            "has_user_editable_resources": false,
            "alt_labels": [
                "degrowth-liike",
                "kohtuutalous",
                "miinuskasvu",
                "vihreä kasvu",
                "nerväxt"
            ],
            "created_time": "2023-08-16T05:16:55.390441Z",
            "last_modified_time": "2023-08-16T05:16:55.390460Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "degrowth-ajattelu",
                "sv": "degrowth",
                "en": "degrowth"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25991/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24185",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:35.912642Z",
            "last_modified_time": "2023-08-16T05:13:35.912669Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "degu",
                "en": "degu"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24185/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39900",
            "has_user_editable_resources": false,
            "alt_labels": [
                "vedyn poisto",
                "dehydrering (kemi)"
            ],
            "created_time": "2023-08-16T05:14:24.731735Z",
            "last_modified_time": "2023-08-16T05:14:24.731754Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dehydraus",
                "sv": "dehydrogenering",
                "en": "dehydration"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39900/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14691",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:26.965983Z",
            "last_modified_time": "2023-08-16T05:05:26.966003Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "deismi",
                "sv": "deism",
                "en": "deism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14691/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27030",
            "has_user_editable_resources": false,
            "alt_labels": [
                "dates (social relations)",
                "treffit",
                "dater",
                "dating",
                "dejtande",
                "dejter",
                "dejting"
            ],
            "created_time": "2023-08-16T05:13:50.264559Z",
            "last_modified_time": "2023-08-16T05:13:50.264576Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "deittailu",
                "sv": "dejtning",
                "en": "dating (social relations)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27030/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28982",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:14.850216Z",
            "last_modified_time": "2023-08-16T05:11:14.850233Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "deittiohjelmat",
                "sv": "dejtprogram",
                "en": "dating shows"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28982/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25341",
            "has_user_editable_resources": false,
            "alt_labels": [
                "datingservice",
                "dejtingservice"
            ],
            "created_time": "2023-08-16T05:10:44.794545Z",
            "last_modified_time": "2023-08-16T05:10:44.794562Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "deittipalvelut",
                "sv": "dejtingtjänster",
                "en": "dating services"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25341/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27057",
            "has_user_editable_resources": false,
            "alt_labels": [
                "deja vu",
                "déjà vu",
                "déjà-vu",
                "déjà-vu-ilmiö",
                "entiselämys",
                "deja vu",
                "déjà-vu"
            ],
            "created_time": "2023-08-16T05:07:19.489667Z",
            "last_modified_time": "2023-08-16T05:07:19.489684Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "déjà vu -ilmiö",
                "sv": "déjà vu",
                "en": "déjà vu"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27057/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26082",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:42.531703Z",
            "last_modified_time": "2023-08-16T05:15:42.531720Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dekaanit",
                "sv": "dekaner",
                "en": "deans"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26082/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25846",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:49.528814Z",
            "last_modified_time": "2025-01-30T04:40:22.312196Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dekabristit",
                "sv": "dekabristerna",
                "en": "Decembrists"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25846/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22686",
            "has_user_editable_resources": false,
            "alt_labels": [
                "dekadans",
                "dekadens (stilar)"
            ],
            "created_time": "2023-08-16T05:13:28.893578Z",
            "last_modified_time": "2023-08-16T05:13:28.893595Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dekadenssi",
                "sv": "dekadens",
                "en": "decadence"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22686/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3836",
            "has_user_editable_resources": false,
            "alt_labels": [
                "dekolonisation",
                "dekolonisering",
                "decolonization"
            ],
            "created_time": "2023-08-16T05:17:52.016577Z",
            "last_modified_time": "2023-08-16T05:17:52.016593Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dekolonisaatio",
                "sv": "avkolonisering",
                "en": "decolonisation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3836/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14904",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:13.160025Z",
            "last_modified_time": "2023-08-16T05:15:13.160044Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dekonstruktio",
                "sv": "dekonstruktion",
                "en": "deconstruction"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14904/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40590",
            "has_user_editable_resources": false,
            "alt_labels": [
                "dekontaminointi",
                "dekontamination"
            ],
            "created_time": "2025-01-21T04:40:53.726826Z",
            "last_modified_time": "2025-01-24T07:25:01.611804Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dekontaminaatio",
                "sv": "dekontaminering",
                "en": "decontamination"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40590/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29422",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:03.476167Z",
            "last_modified_time": "2023-08-16T05:14:03.476185Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dekoriini",
                "sv": "dekorin",
                "en": "decorin"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29422/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39235",
            "has_user_editable_resources": false,
            "alt_labels": [
                "decriminalization",
                "dekriminalisering"
            ],
            "created_time": "2023-08-16T05:14:20.059909Z",
            "last_modified_time": "2023-08-16T05:14:20.059928Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dekriminalisointi",
                "sv": "avkriminalisering",
                "en": "decriminalisation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39235/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39266",
            "has_user_editable_resources": false,
            "alt_labels": [
                "hexadecadrol"
            ],
            "created_time": "2023-08-16T05:11:46.126695Z",
            "last_modified_time": "2023-08-16T05:11:46.126712Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "deksametasoni",
                "sv": "dexametason",
                "en": "dexamethasone"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39266/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16161",
            "has_user_editable_resources": false,
            "alt_labels": [
                "dexmetomidin"
            ],
            "created_time": "2023-08-16T05:05:39.284617Z",
            "last_modified_time": "2023-08-16T05:05:39.284646Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "deksmedetomidiini",
                "sv": "dexmedetomidin",
                "en": "dexmedetomidine"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16161/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26893",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:49.297027Z",
            "last_modified_time": "2023-08-16T05:13:49.297053Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dekstraanit",
                "sv": "dextraner",
                "en": "dextrans"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26893/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}