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=120&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=121&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=119&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p38555",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Bristol Blenheim",
                "Bristol Blenheim",
                "Bristol Blenheim"
            ],
            "created_time": "2023-08-16T05:11:38.944653Z",
            "last_modified_time": "2023-08-16T05:11:38.944671Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Blenheim (lentokoneet)",
                "sv": "Blenheim (flygplan)",
                "en": "Blenheim (airplanes)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38555/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8220",
            "has_user_editable_resources": false,
            "alt_labels": [
                "bliss (symbolspråk)",
                "bliss-språk"
            ],
            "created_time": "2023-08-16T05:08:29.284772Z",
            "last_modified_time": "2023-08-16T05:08:29.284789Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "bliss-kieli",
                "sv": "blissymboler",
                "en": "Blissymbolics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8220/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27727",
            "has_user_editable_resources": false,
            "alt_labels": [
                "bloggarit",
                "blogistit"
            ],
            "created_time": "2023-08-16T05:17:46.346332Z",
            "last_modified_time": "2023-08-16T05:17:46.346350Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "bloggaajat",
                "sv": "bloggare",
                "en": "bloggers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27727/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2719",
            "has_user_editable_resources": false,
            "alt_labels": [
                "weblogs",
                "nettipäiväkirjat",
                "veppilokit",
                "verkkolokit",
                "verkkopäiväkirjat",
                "web-log",
                "weblog",
                "nätdagböcker",
                "webbdagböcker",
                "webbjournaler",
                "webbloggar"
            ],
            "created_time": "2023-08-16T05:18:38.245554Z",
            "last_modified_time": "2023-08-16T05:18:38.245572Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "blogit",
                "sv": "bloggar",
                "en": "blogs"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2719/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39884",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Bloomsbury-gruppen"
            ],
            "created_time": "2023-08-16T05:11:52.327825Z",
            "last_modified_time": "2023-08-16T05:11:52.327844Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Bloomsburyn ryhmä",
                "sv": "Bloomsburygruppen",
                "en": "Bloomsbury group"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39884/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29828",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:05.883484Z",
            "last_modified_time": "2023-08-16T05:14:05.883501Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "bluegrass",
                "en": "bluegrass"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29828/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4482",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:19:05.206610Z",
            "last_modified_time": "2023-08-16T05:19:05.206627Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "blues",
                "en": "blues (Afro-American music)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4482/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39342",
            "has_user_editable_resources": false,
            "alt_labels": [
                "bluesrock",
                "blues rock",
                "blues rock"
            ],
            "created_time": "2023-08-16T05:11:47.019029Z",
            "last_modified_time": "2023-08-16T05:11:47.019048Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "bluesrock",
                "en": "blues rock"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39342/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19981",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:17.926772Z",
            "last_modified_time": "2023-08-16T05:06:17.926790Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Bluetooth",
                "en": "Bluetooth"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19981/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21119",
            "has_user_editable_resources": false,
            "alt_labels": [
                "BD-levyt",
                "blu ray -levyt"
            ],
            "created_time": "2023-08-16T05:10:05.523604Z",
            "last_modified_time": "2023-08-16T05:10:05.523621Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "blu-ray-levyt",
                "sv": "blu-ray-skivor",
                "en": "blu-ray discs"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21119/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16479",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:41.925203Z",
            "last_modified_time": "2023-08-16T05:05:41.925222Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "BMDP",
                "en": "BMDP"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16479/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14344",
            "has_user_editable_resources": false,
            "alt_labels": [
                "temppupyöräily"
            ],
            "created_time": "2023-08-16T05:05:24.811769Z",
            "last_modified_time": "2023-08-16T05:05:24.811786Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "BMX-pyöräily",
                "sv": "BMX-cykling",
                "en": "BMX cycling"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14344/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10341",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:04:59.186680Z",
            "last_modified_time": "2023-08-16T05:04:59.186701Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "boakäärmeet",
                "sv": "boaormar",
                "en": "Boidae"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10341/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28558",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:50.651486Z",
            "last_modified_time": "2023-08-16T05:15:50.651503Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "boccia",
                "en": "boccia"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28558/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22781",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:39.965795Z",
            "last_modified_time": "2023-08-16T05:06:39.965812Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Bodomin kartano",
                "sv": "Bodom gård",
                "en": "Bodom manor"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22781/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29157",
            "has_user_editable_resources": false,
            "alt_labels": [
                "bodo",
                "boro (språk)"
            ],
            "created_time": "2023-08-16T05:07:36.811125Z",
            "last_modified_time": "2023-10-18T04:40:05.176383Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "bodon kieli",
                "sv": "bodo (språk)",
                "en": "Bodo language"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29157/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26182",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:45.810967Z",
            "last_modified_time": "2023-08-16T05:13:45.810983Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "boheemit",
                "sv": "bohemer",
                "en": "bohemians"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26182/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3851",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:15.744580Z",
            "last_modified_time": "2023-08-16T05:14:15.744599Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "boikotti",
                "sv": "bojkott",
                "en": "boycott"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3851/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28894",
            "has_user_editable_resources": false,
            "alt_labels": [
                "bocavirukset"
            ],
            "created_time": "2023-08-16T05:14:00.836467Z",
            "last_modified_time": "2023-08-16T05:14:00.836485Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "bokavirukset",
                "sv": "bocavirus",
                "en": "bocaviruses"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28894/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29378",
            "has_user_editable_resources": false,
            "alt_labels": [
                "bokserikapina"
            ],
            "created_time": "2023-08-16T05:11:19.731568Z",
            "last_modified_time": "2023-08-16T05:11:19.731590Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "boksarikapina",
                "sv": "boxarupproret",
                "en": "Boxer Rebellion"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29378/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}