Keyword List List – Django REST framework

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=1593&show_all_keywords=True

HTTP 200 OK
Allow: GET, POST, HEAD, OPTIONS
Content-Type: application/json ;utf-8
Vary: Accept

{
    "meta": {
        "count": 31901,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1594&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1592&show_all_keywords=True"
    },
    "data": [
        {
            "id": "espoo_le:agggfz66hi",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.096292Z",
            "last_modified_time": "2023-12-13T11:20:12.096316Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 2638,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Espoonlahti",
                "sv": "Esboviken",
                "en": "Espoonlahti"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz66hi/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz65ie",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:11.846704Z",
            "last_modified_time": "2023-12-13T11:20:11.846734Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 2435,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Espoon keskus",
                "sv": "Esbo centrum",
                "en": "Espoon keskus"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz65ie/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz66ky",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.123308Z",
            "last_modified_time": "2023-12-13T11:20:12.123326Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 2428,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Soukka",
                "sv": "Sökö",
                "en": "Soukka"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz66ky/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz65ka",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:11.861544Z",
            "last_modified_time": "2023-12-13T11:20:11.861564Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 2340,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Muurala",
                "sv": "Morby",
                "en": "Muurala"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz65ka/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz65l4",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:11.876507Z",
            "last_modified_time": "2023-12-13T11:20:11.876525Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 2334,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Kaupunginkallio",
                "sv": "Stadsberget",
                "en": "Kaupunginkallio"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz65l4/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz7azy",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.755205Z",
            "last_modified_time": "2023-12-13T11:20:12.755224Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 1662,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "nuoret",
                "sv": "unga",
                "en": "youth"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz7azy/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz66by",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.052436Z",
            "last_modified_time": "2023-12-13T11:20:12.052454Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 1532,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Matinkylä",
                "sv": "Mattby",
                "en": "Matinkylä"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz66by/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz65fm",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:11.825528Z",
            "last_modified_time": "2023-12-13T11:20:11.825556Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 1356,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Tapiola",
                "sv": "Hagalund",
                "en": "Tapiola"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz65fm/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz7axy",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.741193Z",
            "last_modified_time": "2023-12-13T11:20:12.741210Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 1219,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "seniorit",
                "sv": "seniorer",
                "en": "elderly"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz7axy/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz66ru",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.179708Z",
            "last_modified_time": "2023-12-13T11:20:12.179727Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 1100,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Olari",
                "sv": "Olars",
                "en": "Olari"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz66ru/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz675q",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.530825Z",
            "last_modified_time": "2023-12-13T11:20:12.530842Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 889,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Niittykumpu",
                "sv": "Ängskulla",
                "en": "Niittykumpu"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz675q/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz66qa",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.165590Z",
            "last_modified_time": "2023-12-13T11:20:12.165607Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 693,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Suvisaaristo",
                "sv": "Sommaröarna",
                "en": "Suvisaaristo"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz66qa/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz7acu",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.571131Z",
            "last_modified_time": "2023-12-13T11:20:12.571155Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 644,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Pohjois-Tapiola",
                "sv": "Norra Hagalund",
                "en": "Pohjois-Tapiola"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz7acu/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz7ane",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.654416Z",
            "last_modified_time": "2023-12-13T11:20:12.654432Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 642,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Westend",
                "sv": "Westend",
                "en": "Westend"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz7ane/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz66aa",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.038364Z",
            "last_modified_time": "2023-12-13T11:20:12.038383Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 601,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Otaniemi",
                "sv": "Otnäs",
                "en": "Otaniemi"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz66aa/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz66tq",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.193875Z",
            "last_modified_time": "2023-12-13T11:20:12.193895Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 489,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Kilo",
                "sv": "Kilo",
                "en": "Kilo"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz66tq/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz66w4",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.220847Z",
            "last_modified_time": "2023-12-13T11:20:12.220864Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 418,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Lintuvaara",
                "sv": "Fågelberga",
                "en": "Lintuvaara"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz66w4/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz67dq",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.322308Z",
            "last_modified_time": "2023-12-13T11:20:12.322334Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 405,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Suurpelto",
                "sv": "Storåkern",
                "en": "Suurpelto"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz67dq/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz66i4",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.109319Z",
            "last_modified_time": "2023-12-13T11:20:12.109338Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 401,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Nöykkiö",
                "sv": "Nöykis",
                "en": "Nöykkiö"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz66i4/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz67zy",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.499844Z",
            "last_modified_time": "2023-12-13T11:20:12.499862Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 388,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Mankkaa",
                "sv": "Mankans",
                "en": "Mankkaa"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz67zy/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}