GET

Keyword List List

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

{
    "meta": {
        "count": 31963,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=43&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=41&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p17926",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:55.583094Z",
            "last_modified_time": "2023-08-16T05:05:55.583114Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aliurakoitsijat",
                "sv": "underleverantörer",
                "en": "subcontractors"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17926/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29462",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:48.275474Z",
            "last_modified_time": "2023-08-16T05:17:48.275492Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "alkalimetallit",
                "sv": "alkalimetaller",
                "en": "alkali metals"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29462/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28291",
            "has_user_editable_resources": false,
            "alt_labels": [
                "alkaliteetti"
            ],
            "created_time": "2023-08-16T05:17:47.093421Z",
            "last_modified_time": "2023-08-16T05:17:47.093438Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "alkaliniteetti",
                "sv": "alkalinitet",
                "en": "alkalinity"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28291/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11306",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:19:08.740479Z",
            "last_modified_time": "2023-08-16T05:19:08.740497Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "alkaloidit",
                "sv": "alkaloider",
                "en": "alkaloids"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11306/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7723",
            "has_user_editable_resources": false,
            "alt_labels": [
                "alkalinization"
            ],
            "created_time": "2023-08-16T05:08:26.848114Z",
            "last_modified_time": "2025-04-17T04:40:20.267632Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "alkalointi",
                "sv": "alkalisering",
                "en": "alkalinisation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7723/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39279",
            "has_user_editable_resources": false,
            "alt_labels": [
                "olefins",
                "olefiinit",
                "olefiner"
            ],
            "created_time": "2023-08-16T05:08:04.440217Z",
            "last_modified_time": "2023-08-16T05:08:04.440239Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "alkeenit",
                "sv": "alkener",
                "en": "alkenes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39279/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2064",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:19:02.359124Z",
            "last_modified_time": "2023-08-16T05:19:02.359142Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "alkeishiukkaset",
                "sv": "elementarpartiklar",
                "en": "elementary particles"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2064/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24117",
            "has_user_editable_resources": false,
            "alt_labels": [
                "pedagogiot",
                "pedagogier"
            ],
            "created_time": "2023-08-16T05:06:52.915745Z",
            "last_modified_time": "2023-08-16T05:06:52.915764Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "alkeiskoulut",
                "sv": "elementarskolor",
                "en": "grammar school (elementary)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24117/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29793",
            "has_user_editable_resources": false,
            "alt_labels": [
                "elementary level",
                "introductory level"
            ],
            "created_time": "2023-08-16T05:15:55.026312Z",
            "last_modified_time": "2023-08-16T05:15:55.026331Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "alkeistaso",
                "sv": "nybörjarnivå",
                "en": "primary level"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29793/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17440",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:50.814847Z",
            "last_modified_time": "2023-08-16T05:05:50.814868Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "alkemia",
                "sv": "alkemi",
                "en": "alchemy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17440/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19932",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:26.352482Z",
            "last_modified_time": "2023-08-16T05:15:26.352500Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "alkio",
                "sv": "embryo",
                "en": "embryo"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19932/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15416",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:16.671521Z",
            "last_modified_time": "2023-08-16T05:09:16.671544Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "alkiolaisuus",
                "sv": "alkioism",
                "en": "alkiolaisuus"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15416/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7282",
            "has_user_editable_resources": false,
            "alt_labels": [
                "alkiokehitys",
                "embryogeneesi",
                "embryoutveckling"
            ],
            "created_time": "2023-08-16T05:18:00.882430Z",
            "last_modified_time": "2023-08-16T05:18:00.882448Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "alkionkehitys",
                "sv": "embryogenes",
                "en": "embryogenesis"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7282/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5681",
            "has_user_editable_resources": false,
            "alt_labels": [
                "embryo transplantation",
                "embryodonation",
                "embryotransplantation"
            ],
            "created_time": "2023-08-16T05:12:01.576991Z",
            "last_modified_time": "2023-08-16T05:12:01.577011Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "alkionsiirto",
                "sv": "embryoöverföring",
                "en": "embryo transfer"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5681/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1386",
            "has_user_editable_resources": false,
            "alt_labels": [
                "väkijuomat",
                "rusdrycker"
            ],
            "created_time": "2023-08-16T05:19:38.867629Z",
            "last_modified_time": "2023-08-16T05:19:38.867646Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "alkoholijuomat",
                "sv": "alkoholdrycker",
                "en": "alcoholic beverages"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1386/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8391",
            "has_user_editable_resources": false,
            "alt_labels": [
                "juomakulttuuri",
                "dryckeskultur"
            ],
            "created_time": "2023-08-16T05:18:03.149407Z",
            "last_modified_time": "2023-08-16T05:18:03.149428Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "alkoholikulttuuri",
                "sv": "alkoholkultur",
                "en": "drinking culture"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8391/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26894",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:57.620740Z",
            "last_modified_time": "2023-08-16T05:10:57.620766Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "alkoholilaki",
                "sv": "alkohollag",
                "en": "Alcohol Act"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26894/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38742",
            "has_user_editable_resources": false,
            "alt_labels": [
                "alkoholleversjukdomar"
            ],
            "created_time": "2023-08-16T05:11:40.953574Z",
            "last_modified_time": "2023-08-16T05:11:40.953590Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "alkoholimaksasairaudet",
                "sv": "alkoholbetingade leversjukdomar",
                "en": "alcoholic liver diseases"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38742/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19900",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:17.001770Z",
            "last_modified_time": "2023-08-16T05:06:17.001787Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "alkoholimyrkytys",
                "sv": "alkoholförgiftning",
                "en": "alcohol poisoning"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19900/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8393",
            "has_user_editable_resources": false,
            "alt_labels": [
                "alkoholin käyttö",
                "alkoholbruk",
                "alkoholkonsumtion"
            ],
            "created_time": "2023-08-16T05:19:14.008570Z",
            "last_modified_time": "2023-08-16T05:19:14.008588Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "alkoholinkäyttö",
                "sv": "alkoholanvändning",
                "en": "alcohol use"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8393/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}