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=129&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=130&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=128&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p30014",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:43.905196Z",
            "last_modified_time": "2023-08-16T05:07:43.905213Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "cakewalk",
                "en": "cakewalk"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30014/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22783",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:39.985798Z",
            "last_modified_time": "2023-08-16T05:06:39.985814Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Calc",
                "en": "Calc"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22783/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21950",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:33.656433Z",
            "last_modified_time": "2023-08-16T05:06:33.656454Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "calvados",
                "en": "calvados"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21950/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29892",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:48.993338Z",
            "last_modified_time": "2023-08-16T05:17:48.993357Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "calypso",
                "en": "calypso"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29892/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38895",
            "has_user_editable_resources": false,
            "alt_labels": [
                "false flax oil",
                "kitupellavaöljy",
                "ruistankioöljy"
            ],
            "created_time": "2023-08-16T05:11:42.474466Z",
            "last_modified_time": "2023-08-16T05:11:42.474486Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "camelinaöljy",
                "sv": "camelinaolja",
                "en": "camelina oil"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38895/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17288",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:49.147525Z",
            "last_modified_time": "2023-08-16T05:05:49.147543Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "camera obscura",
                "en": "camera obscura"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17288/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18743",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:23.991382Z",
            "last_modified_time": "2023-08-16T05:15:23.991400Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "camp",
                "en": "camp (styles)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18743/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14881",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Camphill (rörelse)"
            ],
            "created_time": "2023-08-16T05:12:49.106080Z",
            "last_modified_time": "2023-08-16T05:12:49.106098Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Camphill-liike",
                "sv": "Camphillrörelsen",
                "en": "Camphill movement"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14881/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28152",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:49.151405Z",
            "last_modified_time": "2023-08-16T05:15:49.151423Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Campus Allegro",
                "en": "Campus Allegro"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28152/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40003",
            "has_user_editable_resources": false,
            "alt_labels": [
                "canariot",
                "canarior"
            ],
            "created_time": "2023-08-16T05:11:53.416854Z",
            "last_modified_time": "2023-08-16T05:11:53.416871Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "canariet",
                "sv": "canarier",
                "en": "canaries (compositions)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40003/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p30041",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:07.129720Z",
            "last_modified_time": "2023-08-16T05:14:07.129739Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "cancanit (sävellykset)",
                "sv": "cancan (kompositioner)",
                "en": "cancans (compositions)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30041/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29996",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:43.758387Z",
            "last_modified_time": "2023-08-16T05:07:43.758405Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "cancan (tanssit)",
                "sv": "cancan (danser)",
                "en": "cancan (dances)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29996/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40323",
            "has_user_editable_resources": false,
            "alt_labels": [
                "callout-kulttuuri",
                "cancel-kulttuuri",
                "cancelointi",
                "call out-kultur",
                "cancel-kultur",
                "cancellering",
                "kränkthetskultur",
                "utfrysningskultur",
                "utraderingskultur",
                "call-out culture"
            ],
            "created_time": "2024-04-06T04:40:24.119912Z",
            "last_modified_time": "2024-05-07T04:40:50.905314Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "cancel-ilmiö",
                "sv": "cancelkultur",
                "en": "cancel culture"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40323/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28299",
            "has_user_editable_resources": false,
            "alt_labels": [
                "candomble",
                "candomble"
            ],
            "created_time": "2023-08-16T05:15:49.537539Z",
            "last_modified_time": "2023-08-16T05:15:49.537562Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "candomblé",
                "en": "Candomblé"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28299/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40062",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:53.947882Z",
            "last_modified_time": "2023-09-02T04:40:22.561088Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "cane corso",
                "en": "cane Corso"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40062/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p30136",
            "has_user_editable_resources": false,
            "alt_labels": [
                "canzona"
            ],
            "created_time": "2023-08-16T05:11:26.373029Z",
            "last_modified_time": "2023-08-16T05:11:26.373046Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "canzonat",
                "sv": "canzoner",
                "en": "canzonas"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30136/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29840",
            "has_user_editable_resources": false,
            "alt_labels": [
                "canzonettas",
                "canzonetta"
            ],
            "created_time": "2023-08-16T05:11:23.667141Z",
            "last_modified_time": "2023-08-16T05:11:23.667163Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "canzonettat",
                "sv": "canzonetter",
                "en": "canzonets"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29840/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15975",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:37.814745Z",
            "last_modified_time": "2023-08-16T05:05:37.814772Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "capoeira",
                "en": "capoeira"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15975/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29896",
            "has_user_editable_resources": false,
            "alt_labels": [
                "caprices",
                "capricciettot",
                "kapriisit",
                "kapriser"
            ],
            "created_time": "2023-08-16T05:11:24.093595Z",
            "last_modified_time": "2023-08-16T05:11:24.093616Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "capricciot",
                "sv": "capriccion",
                "en": "capricci"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29896/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39295",
            "has_user_editable_resources": false,
            "alt_labels": [
                "capris",
                "three-quarter pants",
                "toreador pants",
                "caprit",
                "caprin"
            ],
            "created_time": "2023-08-16T05:08:04.737766Z",
            "last_modified_time": "2023-08-16T05:08:04.737785Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "caprihousut",
                "sv": "capribyxor",
                "en": "capri pants"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39295/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}