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

{
    "meta": {
        "count": 31675,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=226&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=224&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p23025",
            "has_user_editable_resources": false,
            "alt_labels": [
                "äännetietoisuus"
            ],
            "created_time": "2023-08-16T05:10:24.073108Z",
            "last_modified_time": "2023-08-16T05:10:24.073125Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fonologinen tietoisuus",
                "sv": "fonologisk medvetenhet",
                "en": "phonological awareness"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23025/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28089",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:07.948731Z",
            "last_modified_time": "2023-08-16T05:11:07.948751Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fononit",
                "sv": "fononer",
                "en": "phonons"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28089/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22138",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:35.148387Z",
            "last_modified_time": "2023-08-16T05:06:35.148406Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fonotaksi",
                "sv": "fonotax",
                "en": "phonotactics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22138/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23946",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Keisarintalo",
                "Keisaritalo"
            ],
            "created_time": "2023-08-16T05:06:51.232551Z",
            "last_modified_time": "2023-08-16T05:06:51.232569Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Fontellin talo (Lappeenranta)",
                "sv": "Fontells hus (Villmanstrand)",
                "en": "Fontell house (Lappeenranta)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23946/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4751",
            "has_user_editable_resources": false,
            "alt_labels": [
                "B9-vitamiini",
                "B9-vitamin",
                "folinsyra"
            ],
            "created_time": "2023-08-16T05:17:12.460664Z",
            "last_modified_time": "2023-08-16T05:17:12.460681Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "foolihappo",
                "sv": "folsyra",
                "en": "folic acid"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4751/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16914",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:28.621134Z",
            "last_modified_time": "2023-08-16T05:09:28.621153Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fordismi",
                "sv": "fordism",
                "en": "Fordism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16914/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17907",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:55.276273Z",
            "last_modified_time": "2023-08-16T05:05:55.276298Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "formaalinen logiikka",
                "sv": "formell logik",
                "en": "formal logic"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17907/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18414",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:07.772738Z",
            "last_modified_time": "2023-08-16T05:13:07.772755Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "formaatit",
                "sv": "format",
                "en": "formats"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18414/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16085",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:55.574579Z",
            "last_modified_time": "2023-08-16T05:12:55.574607Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "formaldehydi",
                "sv": "formaldehyd",
                "en": "formaldehyde"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16085/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10596",
            "has_user_editable_resources": false,
            "alt_labels": [
                "formalism (idéer)"
            ],
            "created_time": "2023-08-16T05:18:07.333512Z",
            "last_modified_time": "2023-08-16T05:18:07.333528Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "formalismi",
                "sv": "formalism",
                "en": "formalism (ideas)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10596/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6515",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:17.581575Z",
            "last_modified_time": "2023-08-16T05:17:17.581592Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "formiaatit",
                "sv": "formiater",
                "en": "formates"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6515/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40015",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:25.458806Z",
            "last_modified_time": "2023-08-16T05:14:25.458824Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "formiinit",
                "sv": "forminer",
                "en": "formins"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40015/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11184",
            "has_user_editable_resources": false,
            "alt_labels": [
                "formula"
            ],
            "created_time": "2023-08-16T05:08:45.494702Z",
            "last_modified_time": "2023-08-16T05:08:45.494722Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "formula",
                "sv": "formelracing",
                "en": "formula racing"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11184/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19145",
            "has_user_editable_resources": false,
            "alt_labels": [
                "F1",
                "F1 -luokka",
                "F1 -luokka"
            ],
            "created_time": "2023-08-16T05:06:08.454797Z",
            "last_modified_time": "2023-08-16T05:06:08.454816Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Formula 1 -luokka",
                "sv": "Formel 1",
                "en": "Formula one"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19145/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29022",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:01.783516Z",
            "last_modified_time": "2023-08-16T05:14:01.783535Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "formula-analyysi",
                "sv": "formelanalys",
                "en": "formula analysis"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29022/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29354",
            "has_user_editable_resources": false,
            "alt_labels": [
                "formler (narration)"
            ],
            "created_time": "2023-08-16T05:15:53.150760Z",
            "last_modified_time": "2023-08-16T05:15:53.150778Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "formulat (kerronta)",
                "sv": "narrativa formler",
                "en": "formulas (narration)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29354/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38805",
            "has_user_editable_resources": false,
            "alt_labels": [
                "forro",
                "forro",
                "forro"
            ],
            "created_time": "2023-08-16T05:11:41.579893Z",
            "last_modified_time": "2023-08-16T05:11:41.579913Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "forró",
                "en": "forró"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38805/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12748",
            "has_user_editable_resources": false,
            "alt_labels": [
                "vasaraklaveeri",
                "hammarklaver"
            ],
            "created_time": "2023-08-16T05:05:13.411754Z",
            "last_modified_time": "2023-08-16T05:05:13.411772Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fortepiano",
                "en": "fortepiano"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12748/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38399",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:54.838856Z",
            "last_modified_time": "2023-08-16T05:07:54.838873Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Fortnite (peli)",
                "sv": "Fortnite (spel)",
                "en": "Fortnite (game)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38399/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19193",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:08.838407Z",
            "last_modified_time": "2023-08-16T05:06:08.838429Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Fortran",
                "en": "Fortran"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19193/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}