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

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

{
    "meta": {
        "count": 31725,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1506&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1504&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p9708",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:53.900762Z",
            "last_modified_time": "2023-08-16T05:14:53.900785Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voi",
                "sv": "smör",
                "en": "butter"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9708/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11639",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:06.065396Z",
            "last_modified_time": "2023-08-16T05:05:06.065419Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voikasviöljyseokset",
                "sv": "smörväxtoljeblandningar",
                "en": "mixtures of butter and vegetable oils"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11639/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13855",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Taraxacum"
            ],
            "created_time": "2023-08-16T05:05:20.768957Z",
            "last_modified_time": "2023-08-16T05:05:20.768975Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voikukat",
                "sv": "maskrossläktet",
                "en": "dandelions"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13855/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22739",
            "has_user_editable_resources": false,
            "alt_labels": [
                "smörgåskakor"
            ],
            "created_time": "2023-08-16T05:06:39.779104Z",
            "last_modified_time": "2023-08-16T05:06:39.779124Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voileipäkakut",
                "sv": "smörgåstårtor",
                "en": "sandwich cakes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22739/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12952",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:57.945299Z",
            "last_modified_time": "2023-08-16T05:08:57.945326Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voileivät",
                "sv": "smörgåsar",
                "en": "sandwiches"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12952/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5039",
            "has_user_editable_resources": false,
            "alt_labels": [
                "styrka (kraft)"
            ],
            "created_time": "2023-08-16T05:19:05.623476Z",
            "last_modified_time": "2023-08-16T05:19:05.623494Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voima",
                "sv": "kraft",
                "en": "force"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5039/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24516",
            "has_user_editable_resources": false,
            "alt_labels": [
                "täysivaltaistuminen",
                "valtaistuminen",
                "valtautuminen",
                "voimavaraistuminen",
                "empowerment",
                "egenmakt"
            ],
            "created_time": "2023-08-16T05:17:43.752124Z",
            "last_modified_time": "2023-08-16T05:17:43.752154Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voimaantuminen",
                "sv": "empowerment",
                "en": "empowerment"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24516/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13925",
            "has_user_editable_resources": false,
            "alt_labels": [
                "atletik",
                "styrkesport"
            ],
            "created_time": "2023-08-16T05:18:34.320991Z",
            "last_modified_time": "2023-08-16T05:18:34.321019Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voimailu",
                "sv": "kraftsport",
                "en": "strength sports"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13925/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19751",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:15.218237Z",
            "last_modified_time": "2023-08-16T05:06:15.218256Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voimailuvälineet",
                "sv": "tyngdlyftningsredskap",
                "en": "strength training equipment"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19751/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20336",
            "has_user_editable_resources": false,
            "alt_labels": [
                "siirtojohdot",
                "voimansiirtojohdot",
                "kraftöverföringsledningar",
                "överföringsledningar"
            ],
            "created_time": "2023-08-16T05:15:27.059324Z",
            "last_modified_time": "2023-08-16T05:15:27.059342Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voimajohdot",
                "sv": "kraftledningar",
                "en": "power lines"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20336/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22165",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:15.185088Z",
            "last_modified_time": "2023-08-16T05:10:15.185105Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voimakentät (fysiikka)",
                "sv": "kraftfält (fysik)",
                "en": "force fields"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22165/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38153",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:52.122300Z",
            "last_modified_time": "2023-08-16T05:07:52.122319Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voimakentät (kemia)",
                "sv": "kraftfält (kemi)",
                "en": "force fields (chemistry)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38153/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22159",
            "has_user_editable_resources": false,
            "alt_labels": [
                "strength",
                "intensitet",
                "kraftfullhet"
            ],
            "created_time": "2023-08-16T05:06:35.354636Z",
            "last_modified_time": "2023-08-16T05:06:35.354665Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voimakkuus",
                "sv": "styrka",
                "en": "intensity"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22159/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p744",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:20.652105Z",
            "last_modified_time": "2023-08-16T05:17:20.652131Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voimakoneet",
                "sv": "kraftmaskiner",
                "en": "power engines"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p744/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18837",
            "has_user_editable_resources": false,
            "alt_labels": [
                "voimalaitosalueet"
            ],
            "created_time": "2023-08-16T05:15:24.213860Z",
            "last_modified_time": "2023-08-16T05:15:24.213878Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voimala-alueet",
                "sv": "kraftverksområden",
                "en": "power plant areas"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18837/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11481",
            "has_user_editable_resources": false,
            "alt_labels": [
                "power stations",
                "sähkövoimalat",
                "voimalaitokset",
                "elkraftverk"
            ],
            "created_time": "2023-08-16T05:19:00.723399Z",
            "last_modified_time": "2023-08-16T05:19:00.723418Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voimalat",
                "sv": "kraftverk",
                "en": "power plants"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11481/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23254",
            "has_user_editable_resources": false,
            "alt_labels": [
                "strongmangrenar"
            ],
            "created_time": "2023-08-16T05:06:44.339681Z",
            "last_modified_time": "2023-08-16T05:06:44.339699Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voimamiesurheilu",
                "sv": "strongmantävling",
                "en": "strongman sports"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23254/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13804",
            "has_user_editable_resources": false,
            "alt_labels": [
                "voimakeinot",
                "maktmedel"
            ],
            "created_time": "2023-08-16T05:15:09.724468Z",
            "last_modified_time": "2023-08-16T05:15:09.724489Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voimankäyttö",
                "sv": "maktbruk",
                "en": "use of force"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13804/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15351",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:32.179230Z",
            "last_modified_time": "2023-08-16T05:05:32.179250Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voimanosto",
                "sv": "styrkelyft",
                "en": "powerlifting"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15351/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5699",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:57.396047Z",
            "last_modified_time": "2023-08-16T05:17:57.396065Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voimansiirto",
                "sv": "kraftöverföring",
                "en": "power transmission"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5699/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}