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

{
    "meta": {
        "count": 31946,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=311&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=309&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p11963",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:35.488803Z",
            "last_modified_time": "2023-08-16T05:16:35.488821Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "humus",
                "en": "humus"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11963/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24233",
            "has_user_editable_resources": false,
            "alt_labels": [
                "dystrofiset järvet",
                "dystrophic lakes",
                "dystrofa sjöar"
            ],
            "created_time": "2023-08-16T05:10:34.968148Z",
            "last_modified_time": "2023-08-16T05:10:34.968165Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "humusjärvet",
                "sv": "humussjöar",
                "en": "humus lakes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24233/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19754",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:26.088787Z",
            "last_modified_time": "2023-08-16T05:15:26.088804Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "hunaja",
                "sv": "honung",
                "en": "honey"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19754/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14356",
            "has_user_editable_resources": false,
            "alt_labels": [
                "mehiläiskasvit",
                "mesikasvit",
                "biväxter",
                "dragväxter"
            ],
            "created_time": "2023-08-16T05:05:24.886512Z",
            "last_modified_time": "2023-08-16T05:05:24.886531Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "hunajakasvit",
                "sv": "honungsväxter",
                "en": "honey plants"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14356/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19557",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Hunnic people"
            ],
            "created_time": "2023-08-16T05:06:12.644879Z",
            "last_modified_time": "2023-08-16T05:06:12.644897Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "hunnit",
                "sv": "hunner",
                "en": "Huns"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19557/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25707",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:06.939195Z",
            "last_modified_time": "2023-08-16T05:07:06.939213Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "hunnut",
                "sv": "slöjor",
                "en": "veils"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25707/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18497",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:01.158404Z",
            "last_modified_time": "2023-08-16T05:06:01.158423Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Huntingtonin tauti",
                "sv": "Huntingtons sjukdom",
                "en": "Huntington's disease"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18497/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29657",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:54.384690Z",
            "last_modified_time": "2023-08-16T05:15:54.384715Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huojunta (interferenssi)",
                "sv": "svävning (interferens)",
                "en": "beat (interference)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29657/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29662",
            "has_user_editable_resources": false,
            "alt_labels": [
                "fading",
                "huojunta (tasapaino)",
                "svajande",
                "vajande"
            ],
            "created_time": "2023-08-16T05:11:22.002762Z",
            "last_modified_time": "2023-08-16T05:11:22.002779Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huojunta (liike)",
                "sv": "svajning",
                "en": "sway"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29662/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13541",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:18.571328Z",
            "last_modified_time": "2023-08-16T05:05:18.571349Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huokoisuus",
                "sv": "porositet",
                "en": "porosity"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13541/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23096",
            "has_user_editable_resources": false,
            "alt_labels": [
                "noggrannhet"
            ],
            "created_time": "2023-08-16T05:10:24.723465Z",
            "last_modified_time": "2023-08-16T05:10:24.723494Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huolellisuus",
                "sv": "omsorgsfullhet",
                "en": "meticulousness"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23096/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3125",
            "has_user_editable_resources": false,
            "alt_labels": [
                "omvårdnad"
            ],
            "created_time": "2023-08-16T05:15:56.942168Z",
            "last_modified_time": "2023-08-16T05:15:56.942186Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huolenpito",
                "sv": "omsorg",
                "en": "nurture"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3125/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8740",
            "has_user_editable_resources": false,
            "alt_labels": [
                "bekymmer",
                "orolighet",
                "ängslan",
                "ängslighet"
            ],
            "created_time": "2023-08-16T05:12:16.757095Z",
            "last_modified_time": "2023-08-16T05:12:16.757111Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huolestuneisuus",
                "sv": "oro",
                "en": "concern"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8740/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9139",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:51.079306Z",
            "last_modified_time": "2023-08-16T05:14:51.079325Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huolinta",
                "sv": "spedition",
                "en": "forwarding (freight)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9139/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6706",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:06.185389Z",
            "last_modified_time": "2023-08-16T05:12:06.185406Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huolintaliikkeet",
                "sv": "speditionsfirmor",
                "en": "forwarding agencies"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6706/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23312",
            "has_user_editable_resources": false,
            "alt_labels": [
                "persons having custody",
                "providers",
                "försörjare",
                "målsmän"
            ],
            "created_time": "2023-08-16T05:06:45.084370Z",
            "last_modified_time": "2023-08-16T05:06:45.084391Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huoltajat",
                "sv": "vårdnadshavare",
                "en": "guardians"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23312/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27018",
            "has_user_editable_resources": false,
            "alt_labels": [
                "huoltajuusriidat",
                "vårdnadsstrider"
            ],
            "created_time": "2023-08-16T05:13:50.169997Z",
            "last_modified_time": "2023-08-16T05:13:50.170015Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huoltajuuskiistat",
                "sv": "vårdnadstvister",
                "en": "custody disputes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27018/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3283",
            "has_user_editable_resources": false,
            "alt_labels": [
                "care (maintenance)"
            ],
            "created_time": "2023-08-16T05:19:40.554529Z",
            "last_modified_time": "2023-08-16T05:19:40.554547Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huolto",
                "sv": "skötsel",
                "en": "service (maintenance)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3283/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13149",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:59.569923Z",
            "last_modified_time": "2023-08-16T05:08:59.569941Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huoltoapu",
                "sv": "försörjningsbidrag",
                "en": "public welfare"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13149/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20442",
            "has_user_editable_resources": false,
            "alt_labels": [
                "bensinstationer",
                "fuel stations",
                "petrol stations",
                "traffic stations",
                "bensa-asemat",
                "bensiiniasemat",
                "huoltamot",
                "jakeluasemat",
                "liikenneasemat",
                "bensinmackar",
                "distributionsstationer",
                "trafikstationer"
            ],
            "created_time": "2023-08-16T05:18:14.054169Z",
            "last_modified_time": "2023-08-16T05:18:14.054187Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huoltoasemat",
                "sv": "servicestationer",
                "en": "service stations"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20442/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}