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=1353&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=1354&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1352&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p14896",
            "has_user_editable_resources": false,
            "alt_labels": [
                "murhenäytelmät",
                "sorgespel"
            ],
            "created_time": "2023-08-16T05:19:15.707130Z",
            "last_modified_time": "2023-08-16T05:19:15.707148Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tragediat",
                "sv": "tragedier",
                "en": "tragedies"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14896/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27649",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Trager-metoden"
            ],
            "created_time": "2023-08-16T05:07:23.885438Z",
            "last_modified_time": "2023-08-16T05:07:23.885463Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Trager-terapia",
                "sv": "Trager-massage",
                "en": "Trager approach"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27649/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9238",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:26.426753Z",
            "last_modified_time": "2023-08-16T05:17:26.426771Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tragiikka",
                "sv": "tragik",
                "en": "tragedy (styles)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9238/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p786",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:19:19.755163Z",
            "last_modified_time": "2023-08-16T05:19:19.755182Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tragikomediat",
                "sv": "tragikomedier",
                "en": "tragicomedies"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p786/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9242",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:26.446252Z",
            "last_modified_time": "2023-08-16T05:17:26.446293Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tragikomiikka",
                "sv": "tragikomik",
                "en": "tragicomedy (styles)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9242/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24309",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:38.183060Z",
            "last_modified_time": "2023-08-16T05:15:38.183077Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "traktorimerkit",
                "sv": "traktormärken",
                "en": "tractor brands"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24309/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9230",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:30.167343Z",
            "last_modified_time": "2023-08-16T05:18:30.167361Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "traktorit",
                "sv": "traktorer",
                "en": "tractors"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9230/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40051",
            "has_user_editable_resources": false,
            "alt_labels": [
                "power pulling",
                "tractor pulling",
                "tractorpulling"
            ],
            "created_time": "2023-08-16T05:08:12.310772Z",
            "last_modified_time": "2023-08-16T05:08:12.310811Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "traktoriveto",
                "sv": "traktorpulling",
                "en": "tractor pulling"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40051/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22128",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:35.055442Z",
            "last_modified_time": "2023-08-16T05:06:35.055466Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "trampoliinit",
                "sv": "trampoliner",
                "en": "trampolines"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22128/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22130",
            "has_user_editable_resources": false,
            "alt_labels": [
                "trampoliinihyppely",
                "trampolinhopp",
                "trampolin (sport)"
            ],
            "created_time": "2023-08-16T05:06:35.113539Z",
            "last_modified_time": "2023-08-16T05:06:35.113557Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "trampoliinivoimistelu",
                "sv": "trampolingymnastik",
                "en": "trampolining"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22130/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p30024",
            "has_user_editable_resources": false,
            "alt_labels": [
                "trance (musik)"
            ],
            "created_time": "2023-08-16T05:15:55.683712Z",
            "last_modified_time": "2023-08-16T05:15:55.683729Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "trance",
                "en": "trance (electronic dance music)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30024/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19732",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:15.085303Z",
            "last_modified_time": "2023-08-16T05:06:15.085321Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "transaktioanalyysi",
                "sv": "transaktionsanalys",
                "en": "transactional analysis"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19732/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40385",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2024-06-13T04:40:10.606944Z",
            "last_modified_time": "2024-08-29T04:40:16.516893Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "transaktiokustannukset",
                "sv": "transaktionskostnader",
                "en": "transaction costs"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40385/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21692",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:50.429116Z",
            "last_modified_time": "2023-08-16T05:16:50.429136Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "transferaasit",
                "sv": "transferaser",
                "en": "transferases"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21692/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16934",
            "has_user_editable_resources": false,
            "alt_labels": [
                "tunteensiirto",
                "känsloöverföring",
                "transferens",
                "överföring av känslor"
            ],
            "created_time": "2023-08-16T05:09:28.700653Z",
            "last_modified_time": "2023-08-16T05:09:28.700972Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "transferenssi (psykologia)",
                "sv": "överföring (psykologi)",
                "en": "transference (psychology)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16934/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39750",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:09.950455Z",
            "last_modified_time": "2023-08-16T05:17:09.950473Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "transfobia",
                "sv": "transfobi",
                "en": "transphobia"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39750/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12038",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:08.601397Z",
            "last_modified_time": "2023-08-16T05:05:08.601417Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "transformaatioteoria",
                "sv": "transformationsteori",
                "en": "transformational grammar"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12038/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38964",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:43.518623Z",
            "last_modified_time": "2023-08-16T05:11:43.518642Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "transglutaminaasit",
                "sv": "transglutaminaser",
                "en": "transglutaminases"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38964/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p37845",
            "has_user_editable_resources": false,
            "alt_labels": [
                "transgressio (transgressiivisuus)",
                "transgression"
            ],
            "created_time": "2023-08-16T05:07:49.897042Z",
            "last_modified_time": "2023-08-16T05:07:49.897061Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "transgressiivisuus",
                "sv": "transgressivitet",
                "en": "transgression (violation of norms)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p37845/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26735",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:44.258078Z",
            "last_modified_time": "2023-08-16T05:15:44.258095Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "transhumanismi",
                "sv": "transhumanism",
                "en": "transhumanism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26735/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}