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

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

{
    "meta": {
        "count": 31927,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1481&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1479&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p5570",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:14.763352Z",
            "last_modified_time": "2023-08-16T05:17:14.763371Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verkostot",
                "sv": "nätverk",
                "en": "networks (societal phenomena)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5570/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4453",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:28.029133Z",
            "last_modified_time": "2023-08-16T05:14:28.029152Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verkostotalous",
                "sv": "nätverksekonomi",
                "en": "network economy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4453/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2584",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:44.169557Z",
            "last_modified_time": "2023-08-16T05:13:44.169582Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verkostoterapia",
                "sv": "nätverksterapi",
                "en": "network therapy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2584/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2585",
            "has_user_editable_resources": false,
            "alt_labels": [
                "arbete i nätverk"
            ],
            "created_time": "2023-08-16T05:10:49.605673Z",
            "last_modified_time": "2023-08-16T05:10:49.605692Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verkostotyö",
                "sv": "nätverksarbete",
                "en": "networking (nursing)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2585/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40013",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:11.816544Z",
            "last_modified_time": "2023-08-16T05:08:11.816564Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verkostovaikutus",
                "sv": "nätverkseffekt",
                "en": "network effect"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40013/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2398",
            "has_user_editable_resources": false,
            "alt_labels": [
                "nets"
            ],
            "created_time": "2023-08-16T05:13:34.788337Z",
            "last_modified_time": "2023-08-16T05:13:34.788357Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verkot (esineet)",
                "sv": "nät (föremål)",
                "en": "nets (objects)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2398/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5569",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:19:12.402584Z",
            "last_modified_time": "2023-08-16T05:19:12.402601Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verkot (järjestelmät)",
                "sv": "nät (system)",
                "en": "networks (systems)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5569/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28887",
            "has_user_editable_resources": false,
            "alt_labels": [
                "idunviritys",
                "keväistyminen",
                "keväistäminen",
                "vernalisation",
                "vernalization"
            ],
            "created_time": "2023-08-16T05:11:13.810883Z",
            "last_modified_time": "2023-08-16T05:11:13.810902Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "vernalisaatio",
                "sv": "vernalisering",
                "en": "vernalisation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28887/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15404",
            "has_user_editable_resources": false,
            "alt_labels": [
                "verotusaste",
                "skattesats"
            ],
            "created_time": "2023-08-16T05:09:16.575821Z",
            "last_modified_time": "2023-08-16T05:09:16.575843Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "veroaste",
                "sv": "skattegrad",
                "en": "tax rate"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15404/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17791",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:35.852083Z",
            "last_modified_time": "2023-08-16T05:09:35.852100Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "veroehdotukset",
                "sv": "skatteförslag",
                "en": "tax proposals"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17791/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19413",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:50.869640Z",
            "last_modified_time": "2023-08-16T05:09:50.869656Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verohallinto",
                "sv": "skatteförvaltning",
                "en": "tax administration"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19413/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4211",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:55.023341Z",
            "last_modified_time": "2023-08-16T05:11:55.023361Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verohinnat",
                "sv": "markegångar",
                "en": "tax prices"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4211/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17464",
            "has_user_editable_resources": false,
            "alt_labels": [
                "verohintataksa",
                "verohintataksat"
            ],
            "created_time": "2023-08-16T05:05:51.068598Z",
            "last_modified_time": "2023-08-16T05:05:51.068615Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verohintaluettelot",
                "sv": "markegångstaxor",
                "en": "payment value records"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17464/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17792",
            "has_user_editable_resources": false,
            "alt_labels": [
                "tax declaration",
                "självdeklarationer"
            ],
            "created_time": "2023-08-16T05:13:05.000565Z",
            "last_modified_time": "2023-08-16T05:13:05.000593Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "veroilmoitukset",
                "sv": "skattedeklarationer",
                "en": "tax returns"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17792/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18146",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:57.667583Z",
            "last_modified_time": "2023-08-16T05:05:57.667611Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verokilpailu",
                "sv": "skattekonkurrens",
                "en": "tax competition"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18146/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16271",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:23.443907Z",
            "last_modified_time": "2023-08-16T05:09:23.443924Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verolautakunnat",
                "sv": "skattenämnder",
                "en": "tax boards"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16271/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4302",
            "has_user_editable_resources": false,
            "alt_labels": [
                "verokalenterit",
                "skattekalendrar"
            ],
            "created_time": "2023-08-16T05:11:55.534575Z",
            "last_modified_time": "2023-08-16T05:11:55.534602Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "veroluettelot",
                "sv": "skattelängder",
                "en": "tax lists"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4302/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13595",
            "has_user_editable_resources": false,
            "alt_labels": [
                "tax stamps"
            ],
            "created_time": "2023-08-16T05:09:02.468866Z",
            "last_modified_time": "2023-08-16T05:09:02.468887Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "veromerkit",
                "sv": "skattemärken",
                "en": "revenue stamps"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13595/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25325",
            "has_user_editable_resources": false,
            "alt_labels": [
                "veronkevennykset",
                "skatteminskningar"
            ],
            "created_time": "2023-08-16T05:13:41.590659Z",
            "last_modified_time": "2023-08-16T05:13:41.590676Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "veronalennukset",
                "sv": "skattesänkningar",
                "en": "tax reductions"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25325/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4063",
            "has_user_editable_resources": false,
            "alt_labels": [
                "verohelpotukset",
                "verohuojennukset",
                "skattelindringar"
            ],
            "created_time": "2023-08-16T05:14:26.151418Z",
            "last_modified_time": "2023-08-16T05:14:26.151445Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "veronhuojennukset",
                "sv": "skattelättnader",
                "en": "tax reliefs"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4063/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}