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

{
    "meta": {
        "count": 31684,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=86&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=84&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p29427",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:20.116966Z",
            "last_modified_time": "2023-08-16T05:11:20.116985Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "assassiinit",
                "sv": "assassiner",
                "en": "Assassins (Ismailites)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29427/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p779",
            "has_user_editable_resources": false,
            "alt_labels": [
                "esinekoosteet (taideteokset)",
                "esinesommitelmat (taideteokset)"
            ],
            "created_time": "2023-08-16T05:14:44.734550Z",
            "last_modified_time": "2023-08-16T05:14:44.734566Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "assemblaasit",
                "sv": "assemblage",
                "en": "assemblages"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p779/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7766",
            "has_user_editable_resources": false,
            "alt_labels": [
                "assembler-kieli",
                "assembler",
                "assemblyspråk"
            ],
            "created_time": "2023-08-16T05:08:27.153126Z",
            "last_modified_time": "2023-08-16T05:08:27.153144Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "assembly-kieli",
                "sv": "assemblerspråk",
                "en": "assembly language"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7766/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21381",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:30.118809Z",
            "last_modified_time": "2023-08-16T05:15:30.118828Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "assertiivisuus",
                "sv": "assertivitet",
                "en": "assertiveness"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21381/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18462",
            "has_user_editable_resources": false,
            "alt_labels": [
                "assimilation (lingvistik)",
                "assimilation (ljudväxling)"
            ],
            "created_time": "2023-08-16T05:13:08.051431Z",
            "last_modified_time": "2023-08-16T05:13:08.051454Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "assimilaatio (kielitiede)",
                "sv": "assimilation (språkvetenskap)",
                "en": "assimilation (phoneme variation)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18462/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6142",
            "has_user_editable_resources": false,
            "alt_labels": [
                "assimilation (förändring)"
            ],
            "created_time": "2023-08-16T05:16:15.939059Z",
            "last_modified_time": "2023-08-16T05:16:15.939077Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "assimilaatio (sosiologia)",
                "sv": "assimilation (sociologi)",
                "en": "assimilation (sociology)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6142/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18520",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:08.296942Z",
            "last_modified_time": "2023-08-16T05:13:08.296960Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "assistentit",
                "sv": "assistenter",
                "en": "assistants (university)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18520/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15034",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:29.393674Z",
            "last_modified_time": "2023-08-16T05:05:29.393690Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "assosiaatio",
                "sv": "association",
                "en": "association (cognitive processes)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15034/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15542",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Höga dammen"
            ],
            "created_time": "2023-08-16T05:09:17.659697Z",
            "last_modified_time": "2023-08-16T05:09:17.659721Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Assuanin pato",
                "sv": "Assuandammen",
                "en": "Aswan Dam"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15542/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19470",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:51.527616Z",
            "last_modified_time": "2023-08-16T05:09:51.527633Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "assyrialaiset",
                "sv": "assyrier",
                "en": "Assyrians"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19470/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2195",
            "has_user_editable_resources": false,
            "alt_labels": [
                "assyrologia"
            ],
            "created_time": "2023-08-16T05:13:24.937454Z",
            "last_modified_time": "2023-08-16T05:13:24.937472Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "assyriologia",
                "sv": "assyriologi",
                "en": "assyriology"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2195/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24443",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:37.028082Z",
            "last_modified_time": "2023-08-16T05:10:37.028099Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "assyriologit",
                "sv": "assyriologer",
                "en": "Assyriologists"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24443/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19846",
            "has_user_editable_resources": false,
            "alt_labels": [
                "ashtangajooga",
                "astanga",
                "asthangajooga",
                "voimajooga",
                "ashtanga vinyasa yoga",
                "ashtangayoga"
            ],
            "created_time": "2023-08-16T05:09:54.924335Z",
            "last_modified_time": "2023-08-16T05:09:54.924353Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "astangajooga",
                "sv": "ashtanga yoga",
                "en": "ashtanga yoga"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19846/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28791",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:33.506050Z",
            "last_modified_time": "2023-08-16T05:07:33.506070Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "astatiini",
                "sv": "astat",
                "en": "astatine"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28791/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20528",
            "has_user_editable_resources": false,
            "alt_labels": [
                "atsteekit"
            ],
            "created_time": "2023-08-16T05:10:01.276024Z",
            "last_modified_time": "2023-08-16T05:10:01.276053Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "asteekit",
                "sv": "azteker",
                "en": "Aztecs"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20528/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3759",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Compositae",
                "Asteraceae",
                "mykerökukkaiset",
                "mykerökukkaiskasvit",
                "asterväxter"
            ],
            "created_time": "2023-08-16T05:19:30.027326Z",
            "last_modified_time": "2023-08-16T05:19:30.027345Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "asterikasvit",
                "sv": "korgblommiga växter",
                "en": "Asteraceae"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3759/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27330",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:21.580567Z",
            "last_modified_time": "2023-08-16T05:07:21.580585Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "asteroidit",
                "sv": "asteroider",
                "en": "asteroids"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27330/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11603",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:05.899025Z",
            "last_modified_time": "2023-08-16T05:05:05.899052Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "astevaihtelu",
                "sv": "stadieväxling",
                "en": "consonant gradation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11603/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9022",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:32.777604Z",
            "last_modified_time": "2023-08-16T05:08:32.777622Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "astianpesu",
                "sv": "diskning",
                "en": "dish washing"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9022/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6979",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:07.533290Z",
            "last_modified_time": "2023-08-16T05:12:07.533307Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "astianpesukoneet",
                "sv": "diskmaskiner",
                "en": "dishwashing machines"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6979/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}