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

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

{
    "meta": {
        "count": 31675,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=25&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=23&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p25278",
            "has_user_editable_resources": false,
            "alt_labels": [
                "kasvosokeus",
                "prosopagnosi"
            ],
            "created_time": "2023-08-16T05:13:41.124882Z",
            "last_modified_time": "2023-08-16T05:13:41.124901Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "agnosia",
                "sv": "agnosi",
                "en": "agnosia"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25278/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11676",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:33.033560Z",
            "last_modified_time": "2023-08-16T05:18:33.033577Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "agnostisismi",
                "sv": "agnosticism",
                "en": "agnosticism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11676/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p30063",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:44.484195Z",
            "last_modified_time": "2023-08-16T05:07:44.484213Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "agogiikka",
                "sv": "agogik",
                "en": "agogic"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30063/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23290",
            "has_user_editable_resources": false,
            "alt_labels": [
                "agricultural ecology"
            ],
            "created_time": "2023-08-16T05:10:26.629812Z",
            "last_modified_time": "2023-08-16T05:10:26.629835Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "agroekologia",
                "sv": "agroekologi",
                "en": "agroecology"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23290/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15105",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:30.126848Z",
            "last_modified_time": "2023-08-16T05:05:30.126866Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "agrologit",
                "sv": "agrologer",
                "en": "Bachelors of Agriculture and Forestry"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15105/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p36645",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:30.528413Z",
            "last_modified_time": "2023-08-16T05:11:30.528431Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Agronet (portaali)",
                "sv": "Agronet (portal)",
                "en": "Agronet (portal)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p36645/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19951",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:17.618609Z",
            "last_modified_time": "2023-08-16T05:06:17.618629Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "agronomit",
                "sv": "agronomer",
                "en": "agronomists"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19951/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28464",
            "has_user_editable_resources": false,
            "alt_labels": [
                "aghul"
            ],
            "created_time": "2023-08-16T05:07:30.383050Z",
            "last_modified_time": "2023-08-16T05:07:30.383068Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "agulin kieli",
                "sv": "agul",
                "en": "Aghul language"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28464/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23406",
            "has_user_editable_resources": false,
            "alt_labels": [
                "A-virus",
                "H1N1-virus",
                "influenssa A(H1N1)-virus",
                "H1N1-virus"
            ],
            "created_time": "2023-08-16T05:13:32.489843Z",
            "last_modified_time": "2023-08-16T05:13:32.489878Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "A(H1N1)-virus",
                "en": "A(H1N1) virus"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23406/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21184",
            "has_user_editable_resources": false,
            "alt_labels": [
                "H5N1-virus",
                "A-virus",
                "H5N1-virus"
            ],
            "created_time": "2023-08-16T05:10:06.162806Z",
            "last_modified_time": "2023-08-16T05:10:06.162826Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "A(H5N1)-virus",
                "en": "A(H5N1) virus"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21184/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28981",
            "has_user_editable_resources": false,
            "alt_labels": [
                "ahdas olka -oireyhtymä",
                "ahdas olkanivel -oireyhtymä",
                "ahdas olkapää",
                "skulderimpingement syndrom"
            ],
            "created_time": "2023-08-16T05:07:34.973602Z",
            "last_modified_time": "2023-08-16T05:07:34.973621Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ahdas olka",
                "sv": "skulderinklämningssyndrom",
                "en": "shoulder impingement syndrome"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28981/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12932",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:57.685123Z",
            "last_modified_time": "2023-08-16T05:08:57.685141Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ahdinmoottorit",
                "sv": "kompressionsmotorer",
                "en": "supercharged engines"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12932/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21091",
            "has_user_editable_resources": false,
            "alt_labels": [
                "ångeststörningar"
            ],
            "created_time": "2023-08-16T05:17:41.370366Z",
            "last_modified_time": "2023-08-16T05:17:41.370386Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ahdistuneisuushäiriöt",
                "sv": "ångestsyndrom",
                "en": "anxiety disorders"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21091/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4621",
            "has_user_editable_resources": false,
            "alt_labels": [
                "ahdistuneisuus"
            ],
            "created_time": "2023-08-16T05:19:30.301506Z",
            "last_modified_time": "2023-08-16T05:19:30.301525Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ahdistus",
                "sv": "ångest",
                "en": "anxiety"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4621/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39925",
            "has_user_editable_resources": false,
            "alt_labels": [
                "härdar (ässjor)",
                "smideshärdar",
                "smidesugnar",
                "smidesässjor"
            ],
            "created_time": "2023-08-16T05:08:10.879865Z",
            "last_modified_time": "2023-08-16T05:08:10.879884Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ahjot",
                "sv": "ässjor",
                "en": "forges"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39925/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8124",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:13.246058Z",
            "last_modified_time": "2023-08-16T05:12:13.246075Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ahkeruus",
                "sv": "flit",
                "en": "diligence (working hard)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8124/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15810",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:36.337649Z",
            "last_modified_time": "2023-08-16T05:05:36.337678Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ahma",
                "sv": "järv",
                "en": "wolverine"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15810/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29720",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Ichneumonidae"
            ],
            "created_time": "2023-08-16T05:11:22.528888Z",
            "last_modified_time": "2023-08-16T05:11:22.528907Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ahmaspistiäiset",
                "sv": "brokparasitsteklar",
                "en": "Ichneumonidae"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29720/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23124",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:25.082419Z",
            "last_modified_time": "2023-08-16T05:10:25.082441Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ahneus",
                "sv": "girighet",
                "en": "greed"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23124/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9820",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:54.786764Z",
            "last_modified_time": "2023-08-16T05:14:54.786781Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Ahola",
                "en": "Ahola"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9820/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}