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

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

{
    "meta": {
        "count": 31943,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=67&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=65&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p5034",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:58.896617Z",
            "last_modified_time": "2023-08-16T05:11:58.896634Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "antikvariaatit",
                "sv": "antikvariat",
                "en": "antiquarian book shops"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5034/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10034",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:23.657909Z",
            "last_modified_time": "2023-08-16T05:12:23.657926Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "antiloopit",
                "sv": "antiloper",
                "en": "antelopes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10034/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2937",
            "has_user_editable_resources": false,
            "alt_labels": [
                "antiaine",
                "antimaterie"
            ],
            "created_time": "2023-08-16T05:11:19.663837Z",
            "last_modified_time": "2023-08-16T05:11:19.663856Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "antimateria",
                "en": "antimatter"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2937/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21949",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:33.636838Z",
            "last_modified_time": "2023-08-16T05:06:33.636860Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "antimikrobiset yhdisteet",
                "sv": "antimikrobiska föreningar",
                "en": "antimicrobial compounds"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21949/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22255",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:26.161732Z",
            "last_modified_time": "2023-08-16T05:13:26.161758Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "antimilitarismi",
                "sv": "antimilitarism",
                "en": "antimilitarism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22255/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19103",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:47.663451Z",
            "last_modified_time": "2023-08-16T05:09:47.663469Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "antimoni",
                "sv": "antimon",
                "en": "antimony"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19103/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28063",
            "has_user_editable_resources": false,
            "alt_labels": [
                "AMH",
                "AMH",
                "anti-Müllerian-hormon",
                "anti-Mülleriskt hormon",
                "Müllerinhiberande substans",
                "anti-müllerskt hormon"
            ],
            "created_time": "2023-08-16T05:11:07.694912Z",
            "last_modified_time": "2023-08-16T05:11:07.694930Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "anti-Müllerian hormoni",
                "sv": "anti-Mylleriskt hormon",
                "en": "Anti-Müllerian hormone"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28063/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25524",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:42.337737Z",
            "last_modified_time": "2023-08-16T05:13:42.337755Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "antinomismi",
                "sv": "antinomism",
                "en": "antinomianism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25524/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4727",
            "has_user_editable_resources": false,
            "alt_labels": [
                "hapettumisenestoaineet"
            ],
            "created_time": "2023-08-16T05:19:05.367821Z",
            "last_modified_time": "2023-08-16T05:19:05.367839Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "antioksidantit",
                "sv": "antioxidanter",
                "en": "antioxidants"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4727/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12555",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:55.428705Z",
            "last_modified_time": "2023-08-16T05:08:55.428723Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "antipatia",
                "sv": "antipati",
                "en": "antipathy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12555/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8643",
            "has_user_editable_resources": false,
            "alt_labels": [
                "rasisminvastaisuus"
            ],
            "created_time": "2023-08-16T05:16:25.142726Z",
            "last_modified_time": "2023-08-16T05:16:25.142743Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "antirasismi",
                "sv": "antirasism",
                "en": "anti-racism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8643/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22321",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:17.050241Z",
            "last_modified_time": "2023-08-16T05:10:17.050290Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "antirealismi",
                "sv": "antirealism",
                "en": "anti-realism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22321/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21016",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:27.730226Z",
            "last_modified_time": "2023-08-16T05:06:27.730425Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "antisankarit",
                "sv": "antihjältar",
                "en": "antiheroes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21016/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p610",
            "has_user_editable_resources": false,
            "alt_labels": [
                "anti-Judaism",
                "antisemitism",
                "antijudaismi",
                "juutalaisvastaisuus",
                "antijudaism",
                "judefientlighet"
            ],
            "created_time": "2023-08-16T05:16:15.762759Z",
            "last_modified_time": "2023-08-16T05:16:15.762778Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "antisemitismi",
                "sv": "antisemitism",
                "en": "anti-Semitism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p610/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24796",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:39.036590Z",
            "last_modified_time": "2023-08-16T05:15:39.036607Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "antiteismi",
                "sv": "antiteism",
                "en": "antitheism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24796/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20709",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:27.696637Z",
            "last_modified_time": "2023-08-16T05:15:27.696660Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "antitrombiinit",
                "sv": "antitrombiner",
                "en": "antithrombins"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20709/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10123",
            "has_user_editable_resources": false,
            "alt_labels": [
                "valikoimateokset",
                "urvalsverk"
            ],
            "created_time": "2023-08-16T05:08:38.438348Z",
            "last_modified_time": "2023-08-16T05:08:38.438382Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "antologiat",
                "sv": "antologier",
                "en": "anthologies"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10123/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22804",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:42.611567Z",
            "last_modified_time": "2023-08-16T05:17:42.611586Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "antonymia",
                "sv": "antonymi",
                "en": "antonymy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22804/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6806",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:26.233121Z",
            "last_modified_time": "2023-08-16T05:18:26.233136Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "antonyymit",
                "sv": "antonymer",
                "en": "antonyms"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6806/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20609",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:01.893545Z",
            "last_modified_time": "2023-08-16T05:10:01.893571Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "antosyaanit",
                "sv": "antocyaner",
                "en": "anthocyanins"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20609/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}