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=1568&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=1569&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1567&show_all_keywords=True"
    },
    "data": [
        {
            "id": "kulke:557",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:59.665270Z",
            "last_modified_time": "2024-02-06T13:19:16.763139Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Maahockey"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:557/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:372",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:58.722526Z",
            "last_modified_time": "2024-02-06T13:19:15.502785Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Maastojuoksu"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:372/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:308",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:58.365523Z",
            "last_modified_time": "2024-02-06T13:19:14.964561Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Maksulliset"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:308/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:307",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:58.333163Z",
            "last_modified_time": "2024-02-06T13:19:14.944266Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Maksuttomat"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:307/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:390",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:58.948074Z",
            "last_modified_time": "2024-02-06T13:19:15.820816Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Melonta"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:390/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:433",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:59.222395Z",
            "last_modified_time": "2024-02-06T13:19:16.176974Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Miekkailu"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:433/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:315",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:58.390669Z",
            "last_modified_time": "2024-02-06T13:19:15.004035Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Monikulttuuriset"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:315/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:378",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:58.806222Z",
            "last_modified_time": "2024-02-06T13:19:15.624496Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Moottoriurheilu"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:378/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:77",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:57.870922Z",
            "last_modified_time": "2024-02-06T13:19:14.391437Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Musiikki"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:77/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:286",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:58.299500Z",
            "last_modified_time": "2024-02-06T13:19:14.883681Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Muu"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:286/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:641",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:14:00.090007Z",
            "last_modified_time": "2024-02-06T13:19:17.338291Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Muu hinta"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:641/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:623",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:59.929607Z",
            "last_modified_time": "2024-02-06T13:19:17.139572Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Muu toiminta"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:623/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:550",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:59.555228Z",
            "last_modified_time": "2024-02-06T13:19:16.626406Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Mäkihyppy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:550/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:642",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:14:00.104096Z",
            "last_modified_time": "2024-02-06T13:19:17.359881Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Normaalihinta"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:642/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:79",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:57.885695Z",
            "last_modified_time": "2024-02-06T13:19:14.410871Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Nukketeatteri"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:79/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:392",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:58.979954Z",
            "last_modified_time": "2024-02-06T13:19:15.860012Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Nyrkkeily"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:392/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:453",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:59.441801Z",
            "last_modified_time": "2024-02-06T13:19:16.471382Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Paini"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:453/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:628",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:59.982544Z",
            "last_modified_time": "2024-02-06T13:19:17.222268Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Perheliikunta"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:628/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:328",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:58.516950Z",
            "last_modified_time": "2024-02-06T13:19:15.162765Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Pesäpallo"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:328/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:551",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:59.573024Z",
            "last_modified_time": "2024-02-06T13:19:16.646268Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Petanque"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:551/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}