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

{
    "meta": {
        "count": 31685,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1465&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1463&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p16243",
            "has_user_editable_resources": false,
            "alt_labels": [
                "blodcirkulation",
                "blodomlopp"
            ],
            "created_time": "2023-08-16T05:09:23.298330Z",
            "last_modified_time": "2023-08-16T05:09:23.298350Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verenkierto",
                "sv": "blodomloppet",
                "en": "blood circulation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16243/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4568",
            "has_user_editable_resources": false,
            "alt_labels": [
                "cirkulationsorganen"
            ],
            "created_time": "2023-08-16T05:16:10.038566Z",
            "last_modified_time": "2023-08-16T05:16:10.038611Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verenkiertoelimet",
                "sv": "cirkulationsorgan",
                "en": "circulatory system"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4568/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1714",
            "has_user_editable_resources": false,
            "alt_labels": [
                "circulatory organ diseases"
            ],
            "created_time": "2023-08-16T05:09:30.652857Z",
            "last_modified_time": "2023-08-16T05:09:30.652877Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verenkiertoelinten taudit",
                "sv": "cirkulationsorganens sjukdomar",
                "en": "circulatory system diseases"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1714/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12537",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:04.931891Z",
            "last_modified_time": "2023-08-16T05:15:04.931909Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verenluovutus",
                "sv": "blodgivning",
                "en": "blood donation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12537/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8762",
            "has_user_editable_resources": false,
            "alt_labels": [
                "sepsis",
                "sepsis"
            ],
            "created_time": "2023-08-16T05:12:16.943752Z",
            "last_modified_time": "2023-08-16T05:12:16.943770Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verenmyrkytys",
                "sv": "blodförgiftning",
                "en": "sepsis"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8762/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7682",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:21.481676Z",
            "last_modified_time": "2023-08-16T05:16:21.481693Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verenpaine",
                "sv": "blodtryck",
                "en": "blood pressure"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7682/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p37888",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:32.488576Z",
            "last_modified_time": "2023-08-16T05:11:32.488594Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verenpainemittarit",
                "sv": "blodtrycksmätare",
                "en": "sphygmomanometers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p37888/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29032",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:01.822164Z",
            "last_modified_time": "2023-08-16T05:14:01.822181Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verenseisautus",
                "sv": "blodstämning",
                "en": "bloodstopping"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29032/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14319",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:46.301577Z",
            "last_modified_time": "2023-08-16T05:12:46.301605Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verensiirto",
                "sv": "blodtransfusion",
                "en": "blood transfusion"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14319/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6955",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:18.792217Z",
            "last_modified_time": "2023-08-16T05:16:18.792254Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verensokeri",
                "sv": "blodsocker",
                "en": "blood sugar"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6955/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16148",
            "has_user_editable_resources": false,
            "alt_labels": [
                "bleeding"
            ],
            "created_time": "2023-08-16T05:16:43.985980Z",
            "last_modified_time": "2023-08-16T05:16:43.985998Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verenvuoto",
                "sv": "blödning",
                "en": "hemorrhage"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16148/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8018",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:45.903971Z",
            "last_modified_time": "2023-08-16T05:14:45.903990Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verhoilijat",
                "sv": "tapetserare",
                "en": "upholsterers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8018/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12283",
            "has_user_editable_resources": false,
            "alt_labels": [
                "ikkunaverhot",
                "kaihtimet",
                "blinds (curtains)"
            ],
            "created_time": "2023-08-16T05:12:35.634896Z",
            "last_modified_time": "2023-08-16T05:12:35.634914Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verhot",
                "sv": "gardiner",
                "en": "curtains"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12283/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3036",
            "has_user_editable_resources": false,
            "alt_labels": [
                "upholstery",
                "seinäverhoukset",
                "verhoilut (verhoukset)",
                "draperingar",
                "väggbeklädnader",
                "överdrag"
            ],
            "created_time": "2023-08-16T05:18:19.348876Z",
            "last_modified_time": "2023-08-16T05:18:19.348894Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verhoukset",
                "sv": "beklädnader",
                "en": "cladding (construction)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3036/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14506",
            "has_user_editable_resources": false,
            "alt_labels": [
                "blodet"
            ],
            "created_time": "2023-08-16T05:17:35.657466Z",
            "last_modified_time": "2023-08-16T05:17:35.657483Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "veri",
                "sv": "blod",
                "en": "blood"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14506/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38847",
            "has_user_editable_resources": false,
            "alt_labels": [
                "aivo-verieste",
                "aivo-verisuonieste",
                "blod-hjärn-barriär"
            ],
            "created_time": "2023-08-16T05:14:17.571458Z",
            "last_modified_time": "2023-08-16T05:14:17.571484Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "veri-aivoeste",
                "sv": "blod-hjärnbarriär",
                "en": "blood-brain barrier"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38847/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6609",
            "has_user_editable_resources": false,
            "alt_labels": [
                "verifikaatio",
                "verifikation"
            ],
            "created_time": "2023-08-16T05:14:38.575665Z",
            "last_modified_time": "2023-08-16T05:14:38.575681Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verifiointi",
                "sv": "verifiering",
                "en": "verification"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6609/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21326",
            "has_user_editable_resources": false,
            "alt_labels": [
                "trombosyytit"
            ],
            "created_time": "2023-08-16T05:10:07.559193Z",
            "last_modified_time": "2023-08-16T05:10:07.559219Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verihiutaleet",
                "sv": "trombocyter",
                "en": "thrombocytes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21326/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12318",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:53.666635Z",
            "last_modified_time": "2023-08-16T05:08:53.666654Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "veri- ja imusuonitaudit",
                "sv": "blod- och lymfkärlssjukdomar",
                "en": "blood and lymph diseases"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12318/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24331",
            "has_user_editable_resources": false,
            "alt_labels": [
                "medicinal leeches",
                "iilimadot"
            ],
            "created_time": "2023-08-16T05:06:54.738619Z",
            "last_modified_time": "2023-08-16T05:06:54.738638Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "verijuotikkaat",
                "sv": "blodiglar",
                "en": "Hirudo medicinalis"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24331/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}