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

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

{
    "meta": {
        "count": 31684,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=92&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=90&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p16034",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:38.231386Z",
            "last_modified_time": "2023-08-16T05:05:38.231404Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "atomifysiikka",
                "sv": "atomfysik",
                "en": "atomic physics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16034/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27468",
            "has_user_editable_resources": false,
            "alt_labels": [
                "ALD-menetelmä",
                "ALD-tekniikka",
                "ALD-metoden",
                "ALD-teknik",
                "atomlagerdeponering"
            ],
            "created_time": "2023-08-16T05:15:46.726882Z",
            "last_modified_time": "2023-08-16T05:15:46.726901Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "atomikerroskasvatus",
                "sv": "atomlagerdeposition",
                "en": "atomic layer deposition"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27468/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5801",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:15.617477Z",
            "last_modified_time": "2023-08-16T05:17:15.617506Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "atomipainot",
                "sv": "atomvikter",
                "en": "atomic weights"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5801/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15333",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:15.764969Z",
            "last_modified_time": "2023-08-16T05:09:15.764985Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "atomismi",
                "sv": "atomism",
                "en": "atomism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15333/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2985",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:39.519444Z",
            "last_modified_time": "2023-08-16T05:18:39.519462Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "atomit",
                "sv": "atomer",
                "en": "atoms"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2985/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38648",
            "has_user_editable_resources": false,
            "alt_labels": [
                "atomkraftmikroskopi"
            ],
            "created_time": "2023-08-16T05:14:16.573057Z",
            "last_modified_time": "2023-08-16T05:14:16.573076Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "atomivoimamikroskopia",
                "sv": "atomkraftsmikroskopi",
                "en": "atomic force microscopy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38648/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12383",
            "has_user_editable_resources": false,
            "alt_labels": [
                "sävellajittomuus",
                "atonalism"
            ],
            "created_time": "2023-08-16T05:18:09.681850Z",
            "last_modified_time": "2023-08-16T05:18:09.681879Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "atonaalisuus",
                "sv": "atonalitet",
                "en": "atonality"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12383/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p344",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:29.383046Z",
            "last_modified_time": "2023-08-16T05:11:29.383063Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "atopia",
                "sv": "atopi",
                "en": "atopy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p344/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28442",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:50.096779Z",
            "last_modified_time": "2023-08-16T05:15:50.096796Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "atratsiini",
                "sv": "atrazin",
                "en": "atrazine"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28442/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24525",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Atriumhuset (Åbo)"
            ],
            "created_time": "2023-08-16T05:06:56.690664Z",
            "last_modified_time": "2023-08-16T05:06:56.690681Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Atrium (Turku)",
                "sv": "Atrium (Åbo)",
                "en": "Atrium (Turku)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24525/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20904",
            "has_user_editable_resources": false,
            "alt_labels": [
                "surkastumat",
                "surkastuminen",
                "förtvining",
                "förtviningar"
            ],
            "created_time": "2023-08-16T05:13:18.789507Z",
            "last_modified_time": "2023-08-16T05:13:18.789526Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "atrofia",
                "sv": "atrofi",
                "en": "atrophy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20904/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16685",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:43.817723Z",
            "last_modified_time": "2023-08-16T05:05:43.817761Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "atsaleat",
                "sv": "azaleor",
                "en": "azaleas"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16685/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40481",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2024-10-20T04:40:26.398205Z",
            "last_modified_time": "2024-11-13T04:40:21.704081Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "atsobentseeni",
                "sv": "azobensen",
                "en": "azobenzene"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40481/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27765",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:17.561674Z",
            "last_modified_time": "2023-08-16T05:18:17.561704Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "atsolit",
                "sv": "azoler",
                "en": "azoles"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27765/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38581",
            "has_user_editable_resources": false,
            "alt_labels": [
                "azulenes",
                "atsuleenit",
                "azulener"
            ],
            "created_time": "2023-08-16T05:07:57.056923Z",
            "last_modified_time": "2023-08-16T05:07:57.056941Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "atsuleeni",
                "sv": "azulen",
                "en": "azulene"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38581/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5651",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:57.296669Z",
            "last_modified_time": "2023-08-16T05:17:57.296686Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "attentaatit",
                "sv": "attentat",
                "en": "attempted assassinations"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5651/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38900",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:18.202970Z",
            "last_modified_time": "2023-08-16T05:14:18.202988Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "attraktorit",
                "sv": "attraktorer",
                "en": "attractors"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38900/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4690",
            "has_user_editable_resources": false,
            "alt_labels": [
                "attribuointi",
                "attribuering"
            ],
            "created_time": "2023-08-16T05:08:15.283995Z",
            "last_modified_time": "2023-08-16T05:08:15.284014Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "attribuutio",
                "sv": "attribution",
                "en": "attribution"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4690/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18412",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:00.364716Z",
            "last_modified_time": "2023-08-16T05:06:00.364734Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "attribuutioteoria",
                "sv": "attributionsteori",
                "en": "attribution theory"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18412/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7670",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:26.686550Z",
            "last_modified_time": "2023-08-16T05:08:26.686578Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "attribuutti",
                "sv": "attribut",
                "en": "attribute (linguistics)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7670/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}