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=205&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=206&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=204&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p17028",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:29.602070Z",
            "last_modified_time": "2023-08-16T05:09:29.602087Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "etnisyys",
                "sv": "etnicitet",
                "en": "ethnicity"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17028/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25116",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:40.458813Z",
            "last_modified_time": "2023-08-16T05:13:40.458833Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "etnobiologia",
                "sv": "etnobiologi",
                "en": "ethnobiology"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25116/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10301",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:39.764906Z",
            "last_modified_time": "2023-08-16T05:08:39.764925Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "etnobotaniikka",
                "sv": "etnobotanik",
                "en": "ethnobotany"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10301/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28465",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:50.215896Z",
            "last_modified_time": "2023-08-16T05:15:50.215924Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "etnofarmakologia",
                "sv": "etnofarmakologi",
                "en": "ethnopharmacology"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28465/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28600",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:50.803921Z",
            "last_modified_time": "2023-08-16T05:15:50.803938Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "etnofilosofia",
                "sv": "etnofilosofi",
                "en": "ethnophilosophy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28600/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27011",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:57.010000Z",
            "last_modified_time": "2023-08-16T05:16:57.010017Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "etnofuturismi",
                "sv": "etnofuturism",
                "en": "ethnofuturism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27011/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14028",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:35.028945Z",
            "last_modified_time": "2023-08-16T05:17:35.028962Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "etnografia",
                "sv": "etnografi",
                "en": "ethnography"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14028/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29333",
            "has_user_editable_resources": false,
            "alt_labels": [
                "kansatieteelliset museot"
            ],
            "created_time": "2023-08-16T05:07:38.567202Z",
            "last_modified_time": "2023-08-16T05:07:38.567221Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "etnografiset museot",
                "sv": "etnografiska museer",
                "en": "ethnographic museums"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29333/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3914",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:45.107322Z",
            "last_modified_time": "2023-08-16T05:11:45.107339Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "etnohistoria",
                "en": "ethnohistory"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3914/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2809",
            "has_user_editable_resources": false,
            "alt_labels": [
                "antropologinen kielitiede",
                "antropologisk språkvetenskap"
            ],
            "created_time": "2023-08-16T05:17:46.844165Z",
            "last_modified_time": "2023-08-16T05:17:46.844182Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "etnolingvistiikka",
                "sv": "etnolingvistik",
                "en": "ethnolinguistics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2809/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38116",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:14.156138Z",
            "last_modified_time": "2023-08-16T05:14:14.156157Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "etnomatematiikka",
                "sv": "etnomatematik",
                "en": "ethnomathematics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38116/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20561",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:25.108718Z",
            "last_modified_time": "2023-08-16T05:06:25.108800Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "etnometodologia",
                "sv": "etnometodologi",
                "en": "ethnomethodology"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20561/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8727",
            "has_user_editable_resources": false,
            "alt_labels": [
                "kansanmusiikintutkimus",
                "musiikkiantropologia",
                "musiikkietnologia",
                "vertaileva musiikkitiede",
                "folkmusikforskning",
                "jämförande musikvetenskap",
                "musikantropologi",
                "musiketnologi"
            ],
            "created_time": "2023-08-16T05:18:04.371955Z",
            "last_modified_time": "2023-08-16T05:18:04.371972Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "etnomusikologia",
                "sv": "etnomusikologi",
                "en": "ethnomusicology"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8727/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28197",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:59.956618Z",
            "last_modified_time": "2023-08-16T05:16:59.956636Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "etnopoetiikka",
                "sv": "etnopoetik",
                "en": "ethnopoetics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28197/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15285",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:51.591465Z",
            "last_modified_time": "2023-08-16T05:12:51.591485Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "etnopsykologia",
                "sv": "etnopsykologi",
                "en": "ethnopsychology"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15285/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28452",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:47.250472Z",
            "last_modified_time": "2023-08-16T05:17:47.250490Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "etnosemantiikka",
                "sv": "etnosemantik",
                "en": "ethnosemantics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28452/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5168",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:24.038526Z",
            "last_modified_time": "2023-08-16T05:18:24.038544Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "etnosentrismi",
                "sv": "etnocentrism",
                "en": "ethnocentrism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5168/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16734",
            "has_user_editable_resources": false,
            "alt_labels": [
                "eläinpsykologia",
                "djurpsykologi"
            ],
            "created_time": "2023-08-16T05:17:38.454302Z",
            "last_modified_time": "2023-08-16T05:17:38.454333Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "etologia",
                "sv": "etologi",
                "en": "ethology"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16734/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18322",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:59.350726Z",
            "last_modified_time": "2023-08-16T05:05:59.350749Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "etruskin kieli",
                "sv": "etruskiska",
                "en": "Etruscan language"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18322/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20217",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:21.007984Z",
            "last_modified_time": "2023-08-16T05:06:21.008003Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "etruskit",
                "sv": "etrusker",
                "en": "Etruscans"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20217/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}