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

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

{
    "meta": {
        "count": 31945,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1341&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1339&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p23584",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:29.474524Z",
            "last_modified_time": "2023-08-16T05:10:29.474542Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Tillintupa",
                "en": "Tillintupa"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23584/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38472",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:15.626808Z",
            "last_modified_time": "2023-08-16T05:14:15.626834Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tiloroni",
                "sv": "tiloron",
                "en": "tilorone"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38472/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13259",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:07.829824Z",
            "last_modified_time": "2023-08-16T05:15:07.829841Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tilukset",
                "sv": "ägor",
                "en": "pieces of land"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13259/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22098",
            "has_user_editable_resources": false,
            "alt_labels": [
                "ägoreglering"
            ],
            "created_time": "2023-08-16T05:15:32.421337Z",
            "last_modified_time": "2023-08-16T05:15:32.421355Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tilusjärjestelyt",
                "sv": "ägoregleringar",
                "en": "reallocations of pieces of land"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22098/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12930",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:57.664648Z",
            "last_modified_time": "2023-08-16T05:08:57.664666Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "timantti",
                "sv": "diamant",
                "en": "diamond"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12930/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29968",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:43.479104Z",
            "last_modified_time": "2023-08-16T05:07:43.479123Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "timba",
                "en": "timba"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29968/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39002",
            "has_user_editable_resources": false,
            "alt_labels": [
                "timbaalit",
                "timbalesit"
            ],
            "created_time": "2023-08-16T05:08:01.392750Z",
            "last_modified_time": "2023-08-16T05:08:01.392770Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "timbales",
                "en": "timbales"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39002/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17493",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:51.342962Z",
            "last_modified_time": "2023-08-16T05:05:51.342980Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Time Line",
                "en": "Time Line"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17493/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20476",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Phleum pratense"
            ],
            "created_time": "2023-08-16T05:10:00.867744Z",
            "last_modified_time": "2023-08-16T05:10:00.867764Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "timotei",
                "sv": "timotej",
                "en": "timothy-grass"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20476/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17077",
            "has_user_editable_resources": false,
            "alt_labels": [
                "kirvesmiehet"
            ],
            "created_time": "2023-08-16T05:05:47.117883Z",
            "last_modified_time": "2026-01-08T04:40:00.192130Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "timpurit",
                "sv": "timmermän",
                "en": "carpenters (construction workers)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17077/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38968",
            "has_user_editable_resources": false,
            "alt_labels": [
                "T cells",
                "T lymphocytes",
                "T-lymfosyytit",
                "T-solut",
                "T-celler"
            ],
            "created_time": "2023-08-16T05:11:43.538178Z",
            "last_modified_time": "2023-08-16T05:11:43.538196Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "T-imusolut",
                "sv": "T-lymfocyter",
                "en": "T-lymphocytes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38968/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15916",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:20.722176Z",
            "last_modified_time": "2023-08-16T05:09:20.722195Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tina",
                "sv": "tenn",
                "en": "tin"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15916/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40477",
            "has_user_editable_resources": false,
            "alt_labels": [
                "tina(IV)oksidi",
                "tenn(IV)oxid",
                "tin(IV) oxide"
            ],
            "created_time": "2024-10-20T04:40:44.233758Z",
            "last_modified_time": "2025-01-10T04:41:01.249763Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tinadioksidi",
                "sv": "tenndioxid",
                "en": "tin oxide"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40477/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6776",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:06.577481Z",
            "last_modified_time": "2023-08-16T05:12:06.577503Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tinamalmit",
                "sv": "tennmalmer",
                "en": "tin ores"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6776/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18002",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:56.373587Z",
            "last_modified_time": "2023-08-16T05:05:56.373603Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tinamilinnut",
                "sv": "stubbstjärthöns",
                "en": "tinamiformes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18002/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23238",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:26.158983Z",
            "last_modified_time": "2023-08-16T05:10:26.159005Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tinanvalajat",
                "sv": "tennstöpare",
                "en": "tin founders"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23238/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14060",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:22.373914Z",
            "last_modified_time": "2023-08-16T05:05:22.373932Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tinasotilaat",
                "sv": "tennsoldater",
                "en": "tin soldiers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14060/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4698",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:57.363856Z",
            "last_modified_time": "2023-08-16T05:11:57.363874Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tinatyöt",
                "sv": "tennarbeten",
                "en": "tin works"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4698/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18573",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:42.987381Z",
            "last_modified_time": "2023-08-16T05:09:42.987400Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tinaus",
                "sv": "förtenning",
                "en": "tinning"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18573/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1940",
            "has_user_editable_resources": false,
            "alt_labels": [
                "korvien soiminen",
                "öronsusning"
            ],
            "created_time": "2023-08-16T05:16:47.520509Z",
            "last_modified_time": "2023-08-16T05:16:47.520527Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tinnitus",
                "en": "tinnitus"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1940/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}