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

{
    "meta": {
        "count": 31725,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1572&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1570&show_all_keywords=True"
    },
    "data": [
        {
            "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"
        },
        {
            "id": "kulke:552",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:59.584633Z",
            "last_modified_time": "2024-02-06T13:19:16.664784Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Pikaluistelu"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:552/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:230",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:58.242403Z",
            "last_modified_time": "2024-02-06T13:19:14.804222Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Puolitettu hinta"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:230/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:621",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:59.917656Z",
            "last_modified_time": "2024-02-06T13:19:17.120021Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Purjehdus"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:621/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:217",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:58.192396Z",
            "last_modified_time": "2024-02-06T13:19:14.722886Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Pyöräily"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:217/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:558",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:59.680537Z",
            "last_modified_time": "2024-02-06T13:19:16.782978Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Pöytätennis"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:558/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:375",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:58.768613Z",
            "last_modified_time": "2024-02-06T13:19:15.565448Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Ratsastus"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:375/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:432",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:59.207957Z",
            "last_modified_time": "2024-02-06T13:19:16.156817Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Ringette"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:432/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:559",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:59.693777Z",
            "last_modified_time": "2024-02-06T13:19:16.801516Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Rugby"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:559/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:438",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:59.304271Z",
            "last_modified_time": "2024-02-06T13:19:16.271790Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Rullaluistelu"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:438/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:357",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:58.614612Z",
            "last_modified_time": "2024-02-06T13:19:15.322404Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Ruotsi"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:357/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:353",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:58.581955Z",
            "last_modified_time": "2024-02-06T13:19:15.264272Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Ruotsinkieliset"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:353/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:674",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:14:00.302882Z",
            "last_modified_time": "2024-02-06T13:19:17.638368Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Ruotsi (TV)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:674/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:553",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:59.596333Z",
            "last_modified_time": "2024-02-06T13:19:16.684629Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Rusettiluistelu"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:553/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:427",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:59.123842Z",
            "last_modified_time": "2024-02-06T13:19:16.058427Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Ruutiaseammunta"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:427/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:423",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:59.085465Z",
            "last_modified_time": "2024-02-06T13:19:15.997349Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Rytminen voimistelu"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:423/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:561",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:59.718939Z",
            "last_modified_time": "2024-02-06T13:19:16.838807Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Salibandy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:561/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:450",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:59.405497Z",
            "last_modified_time": "2024-02-06T13:19:16.409957Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Salsa"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:450/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:451",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:59.417842Z",
            "last_modified_time": "2024-02-06T13:19:16.430389Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Samba"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:451/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "kulke:371",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-09-07T14:13:58.711927Z",
            "last_modified_time": "2024-02-06T13:19:15.483023Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "kulke",
            "publisher": "ahjo:u48040010",
            "replaced_by": null,
            "name": {
                "fi": "Sauna"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/kulke:371/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}