GET

Keyword List List

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

{
    "meta": {
        "count": 32005,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1244&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1242&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p14041",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:19:21.113158Z",
            "last_modified_time": "2023-08-16T05:19:21.113176Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suorituskyky",
                "sv": "prestationsförmåga",
                "en": "performance (capacity)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14041/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39795",
            "has_user_editable_resources": false,
            "alt_labels": [
                "performance pressure",
                "paineet (suorituspaineet)",
                "prestationskrav",
                "suorittaminen (suorituspaineet)",
                "press (prestationskrav)",
                "presterande (prestationskrav)"
            ],
            "created_time": "2023-08-16T05:17:53.292037Z",
            "last_modified_time": "2023-08-16T05:17:53.292054Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suorituspaineet",
                "sv": "prestationsångest",
                "en": "pressure to perform"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39795/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2009",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:40.262678Z",
            "last_modified_time": "2023-08-16T05:17:40.262696Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suorituspalkka",
                "sv": "prestationslön",
                "en": "incentive wage"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2009/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3618",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:30.299647Z",
            "last_modified_time": "2023-08-16T05:11:30.299665Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suosikit",
                "sv": "favoriter",
                "en": "favourites"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3618/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25408",
            "has_user_editable_resources": false,
            "alt_labels": [
                "suosiminen"
            ],
            "created_time": "2023-08-16T05:10:45.317623Z",
            "last_modified_time": "2023-08-16T05:10:45.317640Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suosinta",
                "sv": "favorisering",
                "en": "favouritism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25408/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3613",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:20.628316Z",
            "last_modified_time": "2023-08-16T05:18:20.628345Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suosio",
                "sv": "popularitet",
                "en": "popularity"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3613/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28483",
            "has_user_editable_resources": false,
            "alt_labels": [
                "suosittelijajärjestelmät",
                "rekommenderingssystem"
            ],
            "created_time": "2023-08-16T05:07:30.528963Z",
            "last_modified_time": "2023-08-16T05:07:30.528982Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suosittelujärjestelmät",
                "sv": "rekommendationssystem",
                "en": "recommender systems"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28483/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9387",
            "has_user_editable_resources": false,
            "alt_labels": [
                "most-favoured-nation clause",
                "MGN-principen",
                "mest-gynnad-nations-klausul"
            ],
            "created_time": "2023-08-16T05:17:26.820061Z",
            "last_modified_time": "2023-08-16T05:17:26.820088Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suosituimmuusperiaate",
                "sv": "mest-gynnad-nations-principen",
                "en": "most-favoured-nation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9387/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7637",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:21.347753Z",
            "last_modified_time": "2023-08-16T05:16:21.347777Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suositukset",
                "sv": "rekommendationer",
                "en": "recommendations"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7637/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21785",
            "has_user_editable_resources": false,
            "alt_labels": [
                "bifall"
            ],
            "created_time": "2023-08-16T05:13:23.846631Z",
            "last_modified_time": "2023-08-16T05:13:23.846649Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suostumus",
                "sv": "samtycke",
                "en": "consent"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21785/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18343",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:59.580729Z",
            "last_modified_time": "2023-08-16T05:05:59.580747Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suostuntavero",
                "sv": "bevillning",
                "en": "suostuntavero"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18343/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5615",
            "has_user_editable_resources": false,
            "alt_labels": [
                "indoktrinaatio",
                "indoktrinering"
            ],
            "created_time": "2023-08-16T05:18:24.592984Z",
            "last_modified_time": "2023-08-16T05:18:24.593011Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suostuttelu",
                "sv": "övertalning",
                "en": "persuasion"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5615/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10981",
            "has_user_editable_resources": false,
            "alt_labels": [
                "myrar",
                "marshes",
                "mires",
                "swamps",
                "mossar",
                "myrmarker"
            ],
            "created_time": "2023-08-16T05:19:08.601030Z",
            "last_modified_time": "2023-08-16T05:19:08.601055Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suot",
                "sv": "kärr",
                "en": "bogs"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10981/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9683",
            "has_user_editable_resources": false,
            "alt_labels": [
                "genomsipprande vatten",
                "perkolationsvatten",
                "sippervatten"
            ],
            "created_time": "2023-08-16T05:14:53.805070Z",
            "last_modified_time": "2023-08-16T05:14:53.805087Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suotovesi",
                "sv": "lakvatten (genomsipprande)",
                "en": "seepage water"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9683/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25034",
            "has_user_editable_resources": false,
            "alt_labels": [
                "kärrtyper"
            ],
            "created_time": "2023-08-16T05:16:54.412585Z",
            "last_modified_time": "2023-08-16T05:16:54.412602Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suotyypit",
                "sv": "myrtyper",
                "en": "peatland types"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25034/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26866",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:44.794910Z",
            "last_modified_time": "2023-08-16T05:15:44.794927Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suoviljely",
                "sv": "mossodling",
                "en": "peatland agriculture"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26866/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8828",
            "has_user_editable_resources": false,
            "alt_labels": [
                "cotton grass"
            ],
            "created_time": "2023-08-16T05:14:49.489546Z",
            "last_modified_time": "2023-08-16T05:14:49.489564Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suovillat",
                "sv": "ullsläktet",
                "en": "Eriophorum"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8828/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26396",
            "has_user_editable_resources": false,
            "alt_labels": [
                "kärrkomplex"
            ],
            "created_time": "2023-08-16T05:17:44.734383Z",
            "last_modified_time": "2023-08-16T05:17:44.734403Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suoyhdistymät",
                "sv": "myrkomplex",
                "en": "mire complexes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26396/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14589",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:26.290417Z",
            "last_modified_time": "2023-08-16T05:05:26.290445Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Superbase",
                "en": "Superbase"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14589/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38242",
            "has_user_editable_resources": false,
            "alt_labels": [
                "suprakondensatorer"
            ],
            "created_time": "2023-08-16T05:07:53.133817Z",
            "last_modified_time": "2023-08-16T05:07:53.133842Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "superkondensaattorit",
                "sv": "superkondensatorer",
                "en": "supercapacitors"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38242/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}