Keyword List List – Django REST framework

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=1294&show_all_keywords=True

HTTP 200 OK
Allow: GET, POST, HEAD, OPTIONS
Content-Type: application/json ;utf-8
Vary: Accept

{
    "meta": {
        "count": 31958,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1295&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1293&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p15357",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Hadenini"
            ],
            "created_time": "2023-08-16T05:12:51.998472Z",
            "last_modified_time": "2024-08-29T04:40:31.007324Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tarhayökköset",
                "sv": "Hadenini",
                "en": "Oligia"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15357/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4895",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:11.268555Z",
            "last_modified_time": "2023-08-16T05:16:11.268571Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tariffit",
                "sv": "tariffer",
                "en": "tariffs"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4895/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p30183",
            "has_user_editable_resources": false,
            "alt_labels": [
                "satuhieronta"
            ],
            "created_time": "2023-08-16T05:11:26.714718Z",
            "last_modified_time": "2023-08-16T05:11:26.714735Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tarinahieronta",
                "sv": "sagomassage",
                "en": "story massage"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30183/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23410",
            "has_user_editable_resources": false,
            "alt_labels": [
                "berättelseteater",
                "playback theater"
            ],
            "created_time": "2023-08-16T05:06:46.277320Z",
            "last_modified_time": "2023-08-16T05:06:46.277349Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tarinateatteri",
                "sv": "playbackteater",
                "en": "playback theatre"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23410/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5161",
            "has_user_editable_resources": false,
            "alt_labels": [
                "waiters",
                "waitresses",
                "servitriser"
            ],
            "created_time": "2023-08-16T05:08:17.267514Z",
            "last_modified_time": "2023-08-16T05:08:17.267531Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tarjoilijat",
                "sv": "servitörer",
                "en": "waiters and waitresses"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5161/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10294",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:39.632010Z",
            "last_modified_time": "2023-08-16T05:08:39.632029Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tarjoilu",
                "sv": "servering",
                "en": "serving"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10294/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9921",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:47.790676Z",
            "last_modified_time": "2023-08-16T05:18:47.790695Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tarjonta",
                "sv": "utbud",
                "en": "supply"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9921/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12672",
            "has_user_editable_resources": false,
            "alt_labels": [
                "anbud",
                "specialerbjudanden",
                "förmånserbjudanden",
                "offerter"
            ],
            "created_time": "2023-08-16T05:18:33.695814Z",
            "last_modified_time": "2023-08-16T05:18:33.695835Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tarjoukset",
                "sv": "erbjudanden",
                "en": "offers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12672/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17081",
            "has_user_editable_resources": false,
            "alt_labels": [
                "anbudsförfrågan",
                "anbudsinfordran",
                "anbudstävlan",
                "anbudstävling",
                "offerttävlan",
                "offerttävling"
            ],
            "created_time": "2023-08-16T05:05:47.176386Z",
            "last_modified_time": "2023-08-16T05:05:47.176407Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tarjouskilpailu",
                "sv": "anbudsförfarande",
                "en": "competitive bidding"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17081/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25236",
            "has_user_editable_resources": false,
            "alt_labels": [
                "offertkalkyl"
            ],
            "created_time": "2023-08-16T05:10:43.953450Z",
            "last_modified_time": "2023-08-16T05:10:43.953468Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tarjouslaskenta",
                "sv": "anbudskalkyl",
                "en": "offer calculation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25236/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p467",
            "has_user_editable_resources": false,
            "alt_labels": [
                "inspection",
                "revision",
                "inspektion"
            ],
            "created_time": "2023-08-16T05:19:41.716409Z",
            "last_modified_time": "2023-08-16T05:19:41.716427Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tarkastus",
                "sv": "granskning",
                "en": "inspection and revision"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p467/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1951",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:12.218647Z",
            "last_modified_time": "2023-08-16T05:06:12.218665Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tarkastuslautakunnat",
                "sv": "prövningsnämnder",
                "en": "appeal boards"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1951/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25192",
            "has_user_editable_resources": false,
            "alt_labels": [
                "granskningsutskott"
            ],
            "created_time": "2023-08-16T05:10:43.358528Z",
            "last_modified_time": "2023-08-16T05:10:43.358547Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tarkastusvaliokunnat",
                "sv": "revisionsutskott",
                "en": "audit committees"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25192/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8294",
            "has_user_editable_resources": false,
            "alt_labels": [
                "foneettinen kirjoitus",
                "foneettinen transkriptio",
                "transkriptio (kielitiede)",
                "äännekirjoitus"
            ],
            "created_time": "2023-08-16T05:16:23.838396Z",
            "last_modified_time": "2023-08-16T05:16:23.838414Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tarkekirjoitus",
                "sv": "fonetisk skrift",
                "en": "phonetic transcription"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8294/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38273",
            "has_user_editable_resources": false,
            "alt_labels": [
                "kontrollistor"
            ],
            "created_time": "2023-08-16T05:07:53.435567Z",
            "last_modified_time": "2023-08-16T05:07:53.435586Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tarkistuslistat",
                "sv": "checklistor",
                "en": "checklists"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38273/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16429",
            "has_user_editable_resources": false,
            "alt_labels": [
                "sharpshooters",
                "krypskyttar",
                "prickskyttar",
                "skarpskyttar"
            ],
            "created_time": "2023-08-16T05:05:41.359255Z",
            "last_modified_time": "2023-09-27T04:39:59.656276Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tarkka-ampujat",
                "sv": "skarpskyttar och prickskyttar",
                "en": "snipers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16429/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9105",
            "has_user_editable_resources": false,
            "alt_labels": [
                "tarkkaavuus"
            ],
            "created_time": "2023-08-16T05:14:50.908934Z",
            "last_modified_time": "2023-08-16T05:14:50.908950Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tarkkaavaisuus",
                "sv": "uppmärksamhet",
                "en": "attention"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9105/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4714",
            "has_user_editable_resources": false,
            "alt_labels": [
                "iakttagelse"
            ],
            "created_time": "2023-08-16T05:18:56.135209Z",
            "last_modified_time": "2023-08-16T05:18:56.135240Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tarkkailu",
                "sv": "iakttagande",
                "en": "surveillance"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4714/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23397",
            "has_user_editable_resources": false,
            "alt_labels": [
                "tarkkailukarjakot"
            ],
            "created_time": "2023-08-16T05:06:46.183384Z",
            "last_modified_time": "2026-06-09T04:39:54.942586Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tarkkailukarjakot",
                "sv": "boskapskontrollanter",
                "en": "tarkkailukarjakko"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23397/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19849",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:16.343086Z",
            "last_modified_time": "2023-08-16T05:06:16.343104Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tarkkailuluokat",
                "sv": "observationsklasser",
                "en": "observation classes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19849/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}