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=142&show_all_keywords=True
HTTP 200 OK
Allow: GET, POST, HEAD, OPTIONS
Content-Type: application/json ;utf-8
Vary: Accept

{
    "meta": {
        "count": 31927,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=143&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=141&show_all_keywords=True"
    },
    "data": [
        {
            "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"
        },
        {
            "id": "yso:p6582",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:17.829530Z",
            "last_modified_time": "2023-08-16T05:17:17.829557Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "delegointi",
                "sv": "delegering",
                "en": "delegating"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6582/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11230",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Delphinidae"
            ],
            "created_time": "2023-08-16T05:12:29.754644Z",
            "last_modified_time": "2023-08-16T05:12:29.754662Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "delfiinit",
                "sv": "delfiner",
                "en": "dolphins"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11230/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9964",
            "has_user_editable_resources": false,
            "alt_labels": [
                "delfimenetelmä",
                "delfoitutkimus",
                "delphi-menetelmä",
                "delfimetod",
                "delfoi-metoden"
            ],
            "created_time": "2023-08-16T05:08:37.251581Z",
            "last_modified_time": "2023-08-16T05:08:37.251605Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "delfoimenetelmä",
                "sv": "delfimetoden",
                "en": "Delphi method"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9964/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26185",
            "has_user_editable_resources": false,
            "alt_labels": [
                "julkisen harkinnan demokratia",
                "diskursiv demokrati",
                "samtalsdemokrati"
            ],
            "created_time": "2023-08-16T05:10:52.448433Z",
            "last_modified_time": "2023-08-16T05:10:52.448451Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "deliberatiivinen demokratia",
                "sv": "deliberativ demokrati",
                "en": "deliberative democracy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26185/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10962",
            "has_user_editable_resources": false,
            "alt_labels": [
                "juoppohulluus",
                "sekavuus",
                "sekavuustila",
                "förvirringstillstånd",
                "konfusion (delirium)",
                "acute confusional state"
            ],
            "created_time": "2023-08-16T05:08:44.109011Z",
            "last_modified_time": "2023-08-16T05:08:44.109040Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "delirium",
                "en": "delirium"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10962/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8666",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:31.159698Z",
            "last_modified_time": "2023-08-16T05:08:31.159717Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Delphi",
                "en": "Delphi"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8666/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1711",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:35.340018Z",
            "last_modified_time": "2023-08-16T05:18:35.340036Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dementia",
                "sv": "demens",
                "en": "dementia"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1711/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4944",
            "has_user_editable_resources": false,
            "alt_labels": [
                "demilitariserade zoner",
                "demilitarized zones"
            ],
            "created_time": "2023-08-16T05:16:11.484499Z",
            "last_modified_time": "2023-08-16T05:16:11.484516Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "demilitarisoidut alueet",
                "sv": "demilitariserade områden",
                "en": "demilitarised zones"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4944/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6379",
            "has_user_editable_resources": false,
            "alt_labels": [
                "demilitarization"
            ],
            "created_time": "2023-08-16T05:14:37.344179Z",
            "last_modified_time": "2023-08-16T05:14:37.344197Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "demilitarisointi",
                "sv": "demilitarisering",
                "en": "demilitarisation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6379/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40547",
            "has_user_editable_resources": false,
            "alt_labels": [
                "deminutiivisuus",
                "diminutiivit",
                "pienennysmuodot",
                "diminutiv"
            ],
            "created_time": "2025-01-23T04:40:25.843269Z",
            "last_modified_time": "2025-01-24T07:25:01.360604Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "deminutiivit",
                "sv": "diminutiver",
                "en": "diminutives"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40547/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39980",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:53.016538Z",
            "last_modified_time": "2023-08-16T05:11:53.016555Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "demiseksuaalisuus",
                "sv": "demisexualitet",
                "en": "demisexuality"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39980/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p742",
            "has_user_editable_resources": false,
            "alt_labels": [
                "kansalaisdemokratia",
                "medborgardemokrati",
                "kansanvalta",
                "folkvälde"
            ],
            "created_time": "2023-08-16T05:19:33.817908Z",
            "last_modified_time": "2023-08-16T05:19:33.817926Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "demokratia",
                "sv": "demokrati",
                "en": "democracy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p742/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15282",
            "has_user_editable_resources": false,
            "alt_labels": [
                "demokratiskt underskott"
            ],
            "created_time": "2023-08-16T05:09:15.378169Z",
            "last_modified_time": "2023-08-16T05:09:15.378187Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "demokratiavaje",
                "sv": "demokratiunderskott",
                "en": "democracy deficit"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15282/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15530",
            "has_user_editable_resources": false,
            "alt_labels": [
                "democratization"
            ],
            "created_time": "2023-08-16T05:09:17.493479Z",
            "last_modified_time": "2023-08-16T05:09:17.493497Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "demokratisoituminen",
                "sv": "demokratisering",
                "en": "democratisation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15530/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11835",
            "has_user_editable_resources": false,
            "alt_labels": [
                "pahat henget",
                "riivaajat",
                "onda andar"
            ],
            "created_time": "2023-08-16T05:16:35.259795Z",
            "last_modified_time": "2023-08-16T05:16:35.259811Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "demonit",
                "sv": "demoner",
                "en": "demons"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11835/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}