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

{
    "meta": {
        "count": 31805,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1591&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1589&show_all_keywords=True"
    },
    "data": [
        {
            "id": "espoo_le:agggfz67bu",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.307740Z",
            "last_modified_time": "2023-12-13T11:20:12.307765Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 54,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Laajalahti",
                "sv": "Bredvik",
                "en": "Laajalahti"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz67bu/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz7aa4",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.557017Z",
            "last_modified_time": "2023-12-13T11:20:12.557037Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 48,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Perusmäki",
                "sv": "Grundbacka",
                "en": "Perusmäki"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz7aa4/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz677i",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.544071Z",
            "last_modified_time": "2023-12-13T11:20:12.544088Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 42,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Nuuksio",
                "sv": "Noux",
                "en": "Nuuksio"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz677i/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:aggo3dhzjq",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2024-01-09T09:28:08.274154Z",
            "last_modified_time": "2024-01-09T09:28:08.274178Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 38,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "työnhakijat",
                "sv": "arbetssökare",
                "en": "jobseekers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:aggo3dhzjq/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz67ku",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.379012Z",
            "last_modified_time": "2023-12-13T11:20:12.379033Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 34,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Karakallio",
                "sv": "Karabacka",
                "en": "Karakallio"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz67ku/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz65uy",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:11.948152Z",
            "last_modified_time": "2023-12-13T11:20:11.948172Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 30,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Nupuri",
                "sv": "Nupurböle",
                "en": "Nupuri"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz65uy/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz65yq",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:11.979072Z",
            "last_modified_time": "2023-12-13T11:20:11.979091Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 30,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Vanha-Nuuksio",
                "sv": "Gamla Noux",
                "en": "Vanha-Nuuksio"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz65yq/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz65re",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:11.918967Z",
            "last_modified_time": "2023-12-13T11:20:11.919009Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 29,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Kolmperä",
                "sv": "Kolmpers",
                "en": "Kolmperä"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz65re/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz67g4",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.349896Z",
            "last_modified_time": "2023-12-13T11:20:12.349921Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 27,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Järvenperä",
                "sv": "Träskända",
                "en": "Järvenperä"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz67g4/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz66ve",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.206619Z",
            "last_modified_time": "2023-12-13T11:20:12.206636Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 27,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Laaksolahti",
                "sv": "Dalsvik",
                "en": "Laaksolahti"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz66ve/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz66yu",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.236299Z",
            "last_modified_time": "2023-12-13T11:20:12.236316Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 21,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Lippajärvi",
                "sv": "Klappträsk",
                "en": "Lippajärvi"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz66yu/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz7alq",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.641407Z",
            "last_modified_time": "2023-12-13T11:20:12.641426Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 21,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Velskola",
                "sv": "Vällskog",
                "en": "Velskola"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz7alq/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz65pm",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:11.905249Z",
            "last_modified_time": "2023-12-13T11:20:11.905267Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 20,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Karvasmäki",
                "sv": "Karvasbacka",
                "en": "Karvasmäki"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz65pm/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz667y",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.292077Z",
            "last_modified_time": "2023-12-13T11:20:12.292102Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 20,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Röylä",
                "sv": "Rödskog",
                "en": "Röylä"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz667y/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz665y",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.276401Z",
            "last_modified_time": "2023-12-13T11:20:12.276418Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 19,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Bodom",
                "sv": "Bodom",
                "en": "Bodom"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz665y/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz664e",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.262489Z",
            "last_modified_time": "2023-12-13T11:20:12.262507Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 19,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Kunnarla",
                "sv": "Gunnars",
                "en": "Kunnarla"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz664e/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz7asq",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.697468Z",
            "last_modified_time": "2023-12-13T11:20:12.697485Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 18,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Högnäs",
                "sv": "Högnäs",
                "en": "Högnäs"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz7asq/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz67ta",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.446650Z",
            "last_modified_time": "2023-12-13T11:20:12.446670Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 17,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Lakisto",
                "sv": "Lakisto",
                "en": "Lakisto"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz67ta/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz65ta",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:11.933839Z",
            "last_modified_time": "2023-12-13T11:20:11.933862Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 16,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Kuurinniitty",
                "sv": "Kurängen",
                "en": "Kuurinniitty"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz65ta/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz65wq",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:11.962441Z",
            "last_modified_time": "2023-12-13T11:20:11.962464Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 16,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Siikajärvi",
                "sv": "Siikajärvi",
                "en": "Siikajärvi"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz65wq/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}