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=229&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=230&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=228&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p22792",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:40.116041Z",
            "last_modified_time": "2023-08-16T05:06:40.116060Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "friisit (kansat)",
                "sv": "friser (folk)",
                "en": "Frisians"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22792/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22793",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:21.869436Z",
            "last_modified_time": "2023-08-16T05:10:21.869456Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "friisit (kuvataide)",
                "sv": "friser (bildkonst)",
                "en": "friezes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22793/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p893",
            "has_user_editable_resources": false,
            "alt_labels": [
                "liitokiekko"
            ],
            "created_time": "2023-08-16T05:14:50.094042Z",
            "last_modified_time": "2023-08-16T05:14:50.094060Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "frisbee",
                "en": "frisbee"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p893/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25200",
            "has_user_editable_resources": false,
            "alt_labels": [
                "kiekkogolf",
                "liitokiekkogolf",
                "frisbeegolf",
                "disk golf"
            ],
            "created_time": "2023-08-16T05:13:40.776712Z",
            "last_modified_time": "2023-08-16T05:13:40.776738Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "frisbeegolf",
                "sv": "discgolf",
                "en": "disc golf"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25200/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22288",
            "has_user_editable_resources": false,
            "alt_labels": [
                "frivoliteettipitsi",
                "frivolité",
                "käpyily",
                "käpypitsi",
                "sukkulapitsi",
                "skyttelspets"
            ],
            "created_time": "2023-08-16T05:10:16.805905Z",
            "last_modified_time": "2023-08-16T05:10:16.805926Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "frivolitee",
                "sv": "frivolitet",
                "en": "tatting"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22288/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14401",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:25.234519Z",
            "last_modified_time": "2023-08-16T05:05:25.234539Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "FrontPage",
                "en": "FrontPage"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14401/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10188",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:04:58.041672Z",
            "last_modified_time": "2023-08-16T05:04:58.041690Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Frugård (Joroinen)",
                "sv": "Frugård (Jorois)",
                "en": "Frugård manor"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10188/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28272",
            "has_user_editable_resources": false,
            "alt_labels": [
                "fruitarianismi",
                "fruitismi",
                "fruktarianism"
            ],
            "created_time": "2023-08-16T05:17:00.104163Z",
            "last_modified_time": "2023-08-16T05:17:00.104181Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fruitarismi",
                "sv": "frukterianism",
                "en": "fruitarianism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28272/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4708",
            "has_user_editable_resources": false,
            "alt_labels": [
                "hedelmäsokeri",
                "fruktsocker"
            ],
            "created_time": "2023-08-16T05:14:29.258523Z",
            "last_modified_time": "2023-08-16T05:14:29.258541Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fruktoosi",
                "sv": "fruktos",
                "en": "fructose"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4708/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14050",
            "has_user_editable_resources": false,
            "alt_labels": [
                "turhautuminen"
            ],
            "created_time": "2023-08-16T05:09:05.956188Z",
            "last_modified_time": "2023-08-16T05:09:05.956205Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "frustraatio",
                "sv": "frustration",
                "en": "frustation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14050/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18039",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:37.997569Z",
            "last_modified_time": "2023-08-16T05:09:37.997587Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ftalaatit",
                "sv": "ftalater",
                "en": "phthalates"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18039/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14433",
            "has_user_editable_resources": false,
            "alt_labels": [
                "File Transfer Protocol",
                "File Transfer Protocol"
            ],
            "created_time": "2023-08-16T05:09:08.770796Z",
            "last_modified_time": "2023-08-16T05:09:08.770814Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "FTP",
                "en": "File Transfer Protocol"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14433/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21697",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:10.976562Z",
            "last_modified_time": "2023-08-16T05:10:10.976582Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fukoosi",
                "sv": "fukos",
                "en": "fucose"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21697/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29505",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:20.655904Z",
            "last_modified_time": "2023-08-16T05:11:20.655922Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Fukushiman ydinonnettomuus",
                "sv": "Fukushimaolyckan",
                "en": "Fukushima Nuclear Accident"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29505/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38607",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Fulah language",
                "Fulani language",
                "Fulbe language",
                "fulben kieli",
                "fulfulden kieli",
                "fula (språk)",
                "fulbe (språk)",
                "fulfulde (språk)",
                "peul (språk)"
            ],
            "created_time": "2023-08-16T05:07:57.517778Z",
            "last_modified_time": "2023-08-16T05:07:57.517807Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fulanin kieli",
                "sv": "fulani (språk)",
                "en": "Fula language"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38607/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14990",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Fulani people",
                "Fulbe people",
                "fulanit",
                "fula (folk)",
                "fulbe (folk)",
                "peul (folk)"
            ],
            "created_time": "2023-08-16T05:05:29.108446Z",
            "last_modified_time": "2023-08-16T05:05:29.108468Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fulbet",
                "sv": "fulani (folk)",
                "en": "Fula people"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14990/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39144",
            "has_user_editable_resources": false,
            "alt_labels": [
                "petrified lightnings",
                "ukonvaajat (fulguriitit)",
                "blixtrör"
            ],
            "created_time": "2023-08-16T05:11:45.126553Z",
            "last_modified_time": "2023-08-16T05:11:45.126570Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fulguriitit",
                "sv": "fulguriter",
                "en": "fulgurites"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39144/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p137",
            "has_user_editable_resources": false,
            "alt_labels": [
                "pallohiili",
                "kolbollar"
            ],
            "created_time": "2023-08-16T05:15:09.266793Z",
            "last_modified_time": "2023-08-16T05:15:09.266812Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fullereenit",
                "sv": "fullerener",
                "en": "fullerenes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p137/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39595",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:49.433933Z",
            "last_modified_time": "2023-08-16T05:11:49.433951Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fundamentaaliteologia",
                "sv": "fundamentalteologi",
                "en": "fundamental theology"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39595/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9609",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:21.629599Z",
            "last_modified_time": "2023-08-16T05:12:21.629617Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fundamentalismi",
                "sv": "fundamentalism",
                "en": "fundamentalism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9609/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}