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=1311&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=1312&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1310&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p3743",
            "has_user_editable_resources": false,
            "alt_labels": [
                "teleterminalapparater"
            ],
            "created_time": "2023-08-16T05:18:20.831685Z",
            "last_modified_time": "2023-08-16T05:18:20.831705Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "telepäätelaitteet",
                "sv": "teleterminalutrustning",
                "en": "telecommunication terminals"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3743/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18392",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:00.191750Z",
            "last_modified_time": "2023-08-16T05:06:00.191769Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "teleteksi",
                "sv": "teletex",
                "en": "teletex"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18392/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24515",
            "has_user_editable_resources": false,
            "alt_labels": [
                "telehealthcare",
                "etäterveydenhuolto",
                "distanshälsovård",
                "vård på distans"
            ],
            "created_time": "2023-08-16T05:13:37.412861Z",
            "last_modified_time": "2023-08-16T05:13:37.412884Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "teleterveydenhuolto",
                "sv": "e-hälsovård",
                "en": "e-healthcare"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24515/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8449",
            "has_user_editable_resources": false,
            "alt_labels": [
                "telset",
                "videotex",
                "teledata",
                "telset"
            ],
            "created_time": "2023-08-16T05:12:15.207204Z",
            "last_modified_time": "2023-08-16T05:12:15.207221Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "teletietopalvelu",
                "sv": "videotex",
                "en": "videotex"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8449/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10798",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:42.987967Z",
            "last_modified_time": "2023-08-16T05:08:42.987984Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "teletoiminta",
                "sv": "televerksamhet",
                "en": "telecommunications activity"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10798/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4712",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:42.316007Z",
            "last_modified_time": "2023-08-16T05:18:42.316025Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "televalvonta",
                "sv": "teleövervakning",
                "en": "monitoring of telecommunications"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4712/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4002",
            "has_user_editable_resources": false,
            "alt_labels": [
                "TV-stationer",
                "televisionsstationer",
                "tevestationer"
            ],
            "created_time": "2023-08-16T05:14:25.478688Z",
            "last_modified_time": "2023-08-16T05:14:25.478707Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "televisioasemat",
                "sv": "tv-stationer",
                "en": "television stations"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4002/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23175",
            "has_user_editable_resources": false,
            "alt_labels": [
                "televisiofilmit",
                "TV-filmer",
                "televisionsfilmer",
                "tevefilmer"
            ],
            "created_time": "2023-08-16T05:10:25.553745Z",
            "last_modified_time": "2023-08-16T05:10:25.553766Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "televisioelokuvat",
                "sv": "tv-filmer",
                "en": "television films"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23175/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28653",
            "has_user_editable_resources": false,
            "alt_labels": [
                "TV-historia",
                "televisionshistoria"
            ],
            "created_time": "2023-08-16T05:13:59.792535Z",
            "last_modified_time": "2023-08-16T05:13:59.792562Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "televisiohistoria",
                "sv": "tv-historia",
                "en": "television history"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28653/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p30151",
            "has_user_editable_resources": false,
            "alt_labels": [
                "tv-uttryck"
            ],
            "created_time": "2023-08-16T05:11:26.451682Z",
            "last_modified_time": "2023-08-16T05:11:26.451700Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "televisioilmaisu",
                "sv": "framställning i tv",
                "en": "artistic expression in television"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30151/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9779",
            "has_user_editable_resources": false,
            "alt_labels": [
                "televisiotoiminta",
                "televisionsverksamhet",
                "televisionssändning",
                "tevesändning",
                "tv-sändning",
                "broadcasting (television)",
                "sändning (televisering)",
                "lähetys (televisiointi)",
                "televisiolähetys",
                "lähetystoiminta (televisiointi)",
                "sändningsverksamhet (televisering)"
            ],
            "created_time": "2023-08-16T05:14:54.401939Z",
            "last_modified_time": "2023-08-16T05:14:54.401965Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "televisiointi",
                "sv": "televisering",
                "en": "television broadcasting"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9779/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18175",
            "has_user_editable_resources": false,
            "alt_labels": [
                "TV-journalistik",
                "tevejournalistik"
            ],
            "created_time": "2023-08-16T05:13:06.695981Z",
            "last_modified_time": "2023-08-16T05:13:06.696000Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "televisiojournalismi",
                "sv": "tv-journalistik",
                "en": "television journalism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18175/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14360",
            "has_user_editable_resources": false,
            "alt_labels": [
                "TV-system",
                "televisionssystem",
                "tevesystem"
            ],
            "created_time": "2023-08-16T05:09:08.203942Z",
            "last_modified_time": "2023-08-16T05:09:08.203961Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "televisiojärjestelmät",
                "sv": "tv-system",
                "en": "television systems"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14360/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15060",
            "has_user_editable_resources": false,
            "alt_labels": [
                "TV-kameror",
                "tevekameror"
            ],
            "created_time": "2023-08-16T05:09:13.768386Z",
            "last_modified_time": "2023-08-16T05:09:13.768405Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "televisiokamerat",
                "sv": "tv-kameror",
                "en": "television cameras"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15060/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8618",
            "has_user_editable_resources": false,
            "alt_labels": [
                "TV-kanaler",
                "televisionskanaler",
                "tevekanaler"
            ],
            "created_time": "2023-08-16T05:12:16.019480Z",
            "last_modified_time": "2023-08-16T05:12:16.019497Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "televisiokanavat",
                "sv": "tv-kanaler",
                "en": "television channels"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8618/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2069",
            "has_user_editable_resources": false,
            "alt_labels": [
                "TV-fostran"
            ],
            "created_time": "2023-08-16T05:10:02.603739Z",
            "last_modified_time": "2023-08-16T05:10:02.603756Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "televisiokasvatus",
                "sv": "tv-fostran",
                "en": "television education"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2069/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10207",
            "has_user_editable_resources": false,
            "alt_labels": [
                "TV-kuvaus",
                "TV-inspelning",
                "televisionsinspelning",
                "teveinspelning"
            ],
            "created_time": "2023-08-16T05:04:58.262377Z",
            "last_modified_time": "2023-08-16T05:04:58.262398Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "televisiokuvaus",
                "sv": "tv-inspelning",
                "en": "television filming"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10207/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20132",
            "has_user_editable_resources": false,
            "alt_labels": [
                "TV-reklam",
                "televisionsreklam",
                "tevereklam"
            ],
            "created_time": "2023-08-16T05:09:57.598876Z",
            "last_modified_time": "2023-08-16T05:09:57.598893Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "televisiomainonta",
                "sv": "tv-reklam",
                "en": "television advertising"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20132/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29877",
            "has_user_editable_resources": false,
            "alt_labels": [
                "musik i TV-program",
                "musik i tv-program",
                "televisionsmusik"
            ],
            "created_time": "2023-08-16T05:14:06.124567Z",
            "last_modified_time": "2023-08-16T05:14:06.124585Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "televisiomusiikki",
                "sv": "tv-musik",
                "en": "television music"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29877/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17196",
            "has_user_editable_resources": false,
            "alt_labels": [
                "TV-skådespel",
                "tevepjäser",
                "tv-pjäser",
                "tv-teatrar (skådespel)"
            ],
            "created_time": "2023-08-16T05:13:01.843206Z",
            "last_modified_time": "2023-08-16T05:13:01.843224Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "televisionäytelmät",
                "sv": "tv-skådespel",
                "en": "television plays"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17196/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}