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=60&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=61&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=59&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p17076",
            "has_user_editable_resources": false,
            "alt_labels": [
                "androgyni"
            ],
            "created_time": "2023-08-16T05:17:38.640009Z",
            "last_modified_time": "2023-08-16T05:17:38.640057Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "androgynia",
                "sv": "androgynitet",
                "en": "androgyny"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17076/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25623",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:05.972525Z",
            "last_modified_time": "2023-08-16T05:07:05.972544Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Android",
                "en": "Android"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25623/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21243",
            "has_user_editable_resources": false,
            "alt_labels": [
                "male climacteric",
                "male menopause"
            ],
            "created_time": "2023-08-16T05:10:06.772435Z",
            "last_modified_time": "2023-08-16T05:10:06.772453Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "andropaussi",
                "sv": "andropaus",
                "en": "andropause"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21243/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15104",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:30.103576Z",
            "last_modified_time": "2023-08-16T05:05:30.103594Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aneet",
                "sv": "avlat",
                "en": "indulgences (religious accomplishments)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15104/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11889",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:33.447730Z",
            "last_modified_time": "2023-08-16T05:12:33.447748Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "anemia",
                "sv": "anemi",
                "en": "anemia"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11889/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15435",
            "has_user_editable_resources": false,
            "alt_labels": [
                "nukutus- ja puudutusoppi"
            ],
            "created_time": "2023-08-16T05:12:52.285055Z",
            "last_modified_time": "2023-08-16T05:12:52.285072Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "anestesiologia",
                "sv": "anestesiologi",
                "en": "anesthesiology"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15435/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16765",
            "has_user_editable_resources": false,
            "alt_labels": [
                "anesthetists",
                "anestesialääkärit",
                "nukutuslääkärit",
                "anestesiläkare",
                "narkosläkare"
            ],
            "created_time": "2023-08-16T05:05:44.389824Z",
            "last_modified_time": "2023-08-16T05:05:44.389840Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "anestesiologit",
                "sv": "anestesiologer",
                "en": "anesthesiologists"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16765/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23458",
            "has_user_editable_resources": false,
            "alt_labels": [
                "aneurism",
                "sydämenpullistuma",
                "valtimonlaajentuma",
                "valtimonpullistuma"
            ],
            "created_time": "2023-08-16T05:15:35.922917Z",
            "last_modified_time": "2023-08-16T05:15:35.922934Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aneurysma",
                "sv": "aneurysm",
                "en": "aneurysm"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23458/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8731",
            "has_user_editable_resources": false,
            "alt_labels": [
                "rasitusrintakipu",
                "angina pectoris"
            ],
            "created_time": "2023-08-16T05:14:48.953361Z",
            "last_modified_time": "2023-08-16T05:14:48.953378Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "angina pectoris",
                "sv": "kärlkramp",
                "en": "angina pectoris"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8731/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27354",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:01.559666Z",
            "last_modified_time": "2023-08-16T05:11:01.559690Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "angiofibrooma",
                "sv": "angiofibrom",
                "en": "angiofibroma"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27354/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22997",
            "has_user_editable_resources": false,
            "alt_labels": [
                "neovascularisation",
                "angiopoieesi",
                "verisuonten uudismuodostus",
                "verisuonten uudistuminen",
                "neovaskularisering",
                "vaskularisation",
                "vaskularisering",
                "neovascularization"
            ],
            "created_time": "2023-08-16T05:10:23.832533Z",
            "last_modified_time": "2023-08-16T05:10:23.832552Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "angiogeneesi",
                "sv": "angiogenes",
                "en": "angiogenesis"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22997/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21602",
            "has_user_editable_resources": false,
            "alt_labels": [
                "verisuonioppi"
            ],
            "created_time": "2023-08-16T05:06:31.253600Z",
            "last_modified_time": "2023-08-16T05:06:31.253617Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "angiologia",
                "sv": "angiologi",
                "en": "angiology"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21602/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7225",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:41.658343Z",
            "last_modified_time": "2023-08-16T05:14:41.658371Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "angioplastia",
                "sv": "angioplastik",
                "en": "angioplasty"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7225/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8767",
            "has_user_editable_resources": false,
            "alt_labels": [
                "episkopaalinen kirkko",
                "episkopala kyrkan"
            ],
            "created_time": "2023-08-16T05:08:31.573244Z",
            "last_modified_time": "2023-08-16T05:08:31.573292Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "anglikaaninen kirkko",
                "sv": "anglikanska kyrkan",
                "en": "Anglican Church"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8767/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6722",
            "has_user_editable_resources": false,
            "alt_labels": [
                "englismit"
            ],
            "created_time": "2023-08-16T05:16:18.072141Z",
            "last_modified_time": "2023-08-16T05:16:18.072160Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "anglismit",
                "sv": "anglicismer",
                "en": "anglicisms"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6722/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26391",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:46.872049Z",
            "last_modified_time": "2023-08-16T05:13:46.872068Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "anglofilia",
                "sv": "anglofili",
                "en": "Anglophilia"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26391/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21909",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:12.884322Z",
            "last_modified_time": "2023-08-16T05:10:12.884342Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "anglonormanni",
                "sv": "anglonormandiska",
                "en": "Anglo-Norman language"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21909/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22194",
            "has_user_editable_resources": false,
            "alt_labels": [
                "anglo-saksit",
                "angelsaxare",
                "anglosaxer"
            ],
            "created_time": "2023-08-16T05:10:15.614964Z",
            "last_modified_time": "2023-08-16T05:10:15.614993Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "anglosaksit",
                "sv": "anglosaxare",
                "en": "Anglo-Saxons"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22194/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40038",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:12.150360Z",
            "last_modified_time": "2023-08-16T05:08:12.150380Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "angolalaiset",
                "sv": "angolaner",
                "en": "Angolans"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40038/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16857",
            "has_user_editable_resources": false,
            "alt_labels": [
                "angorakaniini"
            ],
            "created_time": "2023-08-16T05:09:28.178594Z",
            "last_modified_time": "2023-08-16T05:09:28.178611Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "angorakani",
                "sv": "angorakanin",
                "en": "angora rabbit"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16857/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}