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

{
    "meta": {
        "count": 31759,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=232&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=230&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p23394",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:46.090406Z",
            "last_modified_time": "2023-08-16T05:06:46.090427Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "funktionaalisuus",
                "sv": "funktionalitet",
                "en": "functionality"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23394/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29113",
            "has_user_editable_resources": false,
            "alt_labels": [
                "funktionella ekvationer"
            ],
            "created_time": "2023-08-16T05:14:02.284986Z",
            "last_modified_time": "2023-08-16T05:14:02.285004Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "funktionaaliyhtälöt",
                "sv": "funktionalekvationer",
                "en": "functional equations"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29113/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8963",
            "has_user_editable_resources": false,
            "alt_labels": [
                "funkis",
                "funkkis",
                "funkis"
            ],
            "created_time": "2023-08-16T05:16:26.205640Z",
            "last_modified_time": "2023-08-16T05:16:26.205666Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "funktionalismi",
                "sv": "funktionalism",
                "en": "functionalism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8963/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7097",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:19:28.697547Z",
            "last_modified_time": "2023-08-16T05:19:28.697564Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "funktiot",
                "sv": "funktioner (matematik)",
                "en": "functions (mathematical methods)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7097/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18494",
            "has_user_editable_resources": false,
            "alt_labels": [
                "function theory",
                "kompleksianalyysi",
                "komplex analys"
            ],
            "created_time": "2023-08-16T05:09:42.270002Z",
            "last_modified_time": "2023-08-16T05:09:42.270019Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "funktioteoria",
                "sv": "funktionsteori",
                "en": "complex analysis"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18494/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7657",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:01.890193Z",
            "last_modified_time": "2023-08-16T05:18:01.890212Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "furaanit",
                "sv": "furaner",
                "en": "furans"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7657/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28979",
            "has_user_editable_resources": false,
            "alt_labels": [
                "furan-2-karbaldehyd",
                "furfurol"
            ],
            "created_time": "2023-08-16T05:14:01.386440Z",
            "last_modified_time": "2023-08-16T05:14:01.386462Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "furfuraali",
                "sv": "furfural",
                "en": "furfural"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28979/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38975",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:43.642048Z",
            "last_modified_time": "2023-08-16T05:11:43.642065Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "furiini",
                "sv": "furin",
                "en": "furin"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38975/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39168",
            "has_user_editable_resources": false,
            "alt_labels": [
                "lava-jive",
                "single-time swing"
            ],
            "created_time": "2023-08-16T05:14:19.396066Z",
            "last_modified_time": "2023-08-16T05:14:19.396084Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fusku (tanssit)",
                "sv": "fusku (danser)",
                "en": "fusku (dances)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39168/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6408",
            "has_user_editable_resources": false,
            "alt_labels": [
                "salijalkapallo",
                "sisäjalkapallo",
                "innefotboll",
                "inomhusfotboll",
                "indoor soccer"
            ],
            "created_time": "2023-08-16T05:08:21.695016Z",
            "last_modified_time": "2023-08-16T05:08:21.695034Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "futsal",
                "en": "futsal"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6408/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1323",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:38.380718Z",
            "last_modified_time": "2023-08-16T05:16:38.380736Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "futurismi",
                "sv": "futurism",
                "en": "futurism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1323/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25720",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:07.080642Z",
            "last_modified_time": "2023-08-16T05:07:07.080662Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "futuuri",
                "sv": "futurum",
                "en": "future tense"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25720/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15927",
            "has_user_editable_resources": false,
            "alt_labels": [
                "futures contracts",
                "future",
                "futurekontrakt",
                "futures",
                "futurkontrakt"
            ],
            "created_time": "2023-08-16T05:09:20.851563Z",
            "last_modified_time": "2023-08-16T05:09:20.851582Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "futuurit",
                "sv": "futurer",
                "en": "futures"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15927/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16025",
            "has_user_editable_resources": false,
            "alt_labels": [
                "fugatot",
                "fughetat"
            ],
            "created_time": "2023-08-16T05:15:16.820482Z",
            "last_modified_time": "2023-08-16T05:15:16.820500Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fuugat",
                "sv": "fugor",
                "en": "fugues"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16025/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26054",
            "has_user_editable_resources": false,
            "alt_labels": [
                "fuusiovoima"
            ],
            "created_time": "2023-08-16T05:07:10.477887Z",
            "last_modified_time": "2023-08-16T05:07:10.477904Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fuusioenergia",
                "sv": "fusionsenergi",
                "en": "fusion energy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26054/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11367",
            "has_user_editable_resources": false,
            "alt_labels": [
                "cross kitchen",
                "cross kitchen",
                "cross kitchen"
            ],
            "created_time": "2023-08-16T05:12:30.412525Z",
            "last_modified_time": "2023-08-16T05:12:30.412543Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fuusiokeittiö",
                "sv": "fusionskök",
                "en": "fusion cuisine"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11367/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7198",
            "has_user_editable_resources": false,
            "alt_labels": [
                "jazz-rock",
                "jazz-rock",
                "popjazz",
                "jazzrock",
                "popjazz"
            ],
            "created_time": "2023-08-16T05:14:41.518502Z",
            "last_modified_time": "2023-08-16T05:14:41.518519Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fuusiomusiikki",
                "sv": "fusionsmusik",
                "en": "fusion music"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7198/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19475",
            "has_user_editable_resources": false,
            "alt_labels": [
                "fuusio (ydinreaktiot)",
                "ydinfuusio",
                "fusion (kärnfysik)",
                "fusionsreaktion",
                "kärnfusion"
            ],
            "created_time": "2023-08-16T05:09:51.566391Z",
            "last_modified_time": "2023-08-16T05:09:51.566409Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fuusioreaktio",
                "sv": "fusion (kärnreaktioner)",
                "en": "nuclear fusion"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19475/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28207",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:08.588080Z",
            "last_modified_time": "2023-08-16T05:11:08.588098Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fylogenetiikka",
                "sv": "fylogenetik",
                "en": "phylogenetics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28207/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25760",
            "has_user_editable_resources": false,
            "alt_labels": [
                "fylogeneesi",
                "fylogenes"
            ],
            "created_time": "2023-08-16T05:13:43.640656Z",
            "last_modified_time": "2023-08-16T05:13:43.640677Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fylogenia",
                "sv": "fylogeni",
                "en": "phylogeny"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25760/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}