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=267&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=268&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=266&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p29637",
            "has_user_editable_resources": false,
            "alt_labels": [
                "hardcorepunk",
                "hc punk",
                "hardcore (punk)",
                "hc punk"
            ],
            "created_time": "2023-08-16T05:11:21.731323Z",
            "last_modified_time": "2023-08-16T05:11:21.731342Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "hardcore punk",
                "sv": "hardcorepunk",
                "en": "hardcore punk music"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29637/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29714",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:22.470814Z",
            "last_modified_time": "2023-08-16T05:11:22.470833Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Hardyn avaruudet",
                "sv": "Hardyrum",
                "en": "Hardy spaces"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29714/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10960",
            "has_user_editable_resources": false,
            "alt_labels": [
                "aistiharhat",
                "hallusinaatiot",
                "sinnesvillor"
            ],
            "created_time": "2023-08-16T05:18:07.886210Z",
            "last_modified_time": "2023-08-16T05:18:07.886226Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "harha-aistimukset",
                "sv": "hallucinationer",
                "en": "hallucinations"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10960/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15455",
            "has_user_editable_resources": false,
            "alt_labels": [
                "kerettiläisyys",
                "heresi",
                "heterodoxi",
                "irrläror",
                "kätteri",
                "kätterskhet",
                "villoläror"
            ],
            "created_time": "2023-08-16T05:05:33.231919Z",
            "last_modified_time": "2023-08-16T05:05:33.231937Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "harhaoppisuus",
                "sv": "irrlärighet",
                "en": "heresy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15455/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24506",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:37.283184Z",
            "last_modified_time": "2023-08-16T05:13:37.283212Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "harhat",
                "sv": "villfarelser",
                "en": "delusions"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24506/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22925",
            "has_user_editable_resources": false,
            "alt_labels": [
                "misleading",
                "harhautus",
                "fintande"
            ],
            "created_time": "2023-08-16T05:10:22.915143Z",
            "last_modified_time": "2023-08-16T05:10:22.915161Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "harhauttaminen",
                "sv": "vilseledning",
                "en": "feinting"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22925/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13046",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:15.516514Z",
            "last_modified_time": "2023-08-16T05:05:15.516533Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "harjaantumisopetus",
                "sv": "träningsundervisning",
                "en": "special education of disabled pupils"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13046/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16094",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:38.754223Z",
            "last_modified_time": "2023-08-16T05:05:38.754240Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "harjakatot",
                "sv": "sadeltak",
                "en": "ridge roofs"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16094/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28238",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Upupa epops"
            ],
            "created_time": "2023-08-16T05:07:28.558762Z",
            "last_modified_time": "2023-08-16T05:07:28.558782Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "harjalintu",
                "sv": "härfågel",
                "en": "hoopoe"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28238/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29347",
            "has_user_editable_resources": false,
            "alt_labels": [
                "harjakaiset",
                "taklagsöl"
            ],
            "created_time": "2023-08-16T05:11:19.510227Z",
            "last_modified_time": "2023-08-16T05:11:19.510247Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "harjannostajaiset",
                "sv": "taklagsfester",
                "en": "topping out"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29347/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26897",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:17.714721Z",
            "last_modified_time": "2023-08-16T05:07:17.714742Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "harjaravut",
                "sv": "Atyidae",
                "en": "Atyidae"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26897/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23020",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:42.252046Z",
            "last_modified_time": "2023-08-16T05:06:42.252063Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "harjat",
                "sv": "borstar",
                "en": "brooms and brushes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23020/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24969",
            "has_user_editable_resources": false,
            "alt_labels": [
                "liikkeet (harjoitteet)",
                "rörelser (träningsmoment)",
                "övningsmoment"
            ],
            "created_time": "2023-08-16T05:13:39.581517Z",
            "last_modified_time": "2023-08-16T05:13:39.581536Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "harjoitteet",
                "sv": "träningsmoment",
                "en": "physical exercises"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24969/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23300",
            "has_user_editable_resources": false,
            "alt_labels": [
                "interns"
            ],
            "created_time": "2023-08-16T05:06:44.937701Z",
            "last_modified_time": "2023-08-16T05:06:44.937718Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "harjoittelijat",
                "sv": "praktikanter",
                "en": "trainees"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23300/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2093",
            "has_user_editable_resources": false,
            "alt_labels": [
                "exchange of interns",
                "harjoittelijainvaihto"
            ],
            "created_time": "2023-08-16T05:18:36.645969Z",
            "last_modified_time": "2023-08-16T05:18:36.645987Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "harjoittelijavaihto",
                "sv": "praktikantutbyte",
                "en": "exchange of trainees"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2093/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26412",
            "has_user_editable_resources": false,
            "alt_labels": [
                "practicing",
                "treenaaminen",
                "treenaus",
                "övning",
                "practising"
            ],
            "created_time": "2023-08-16T05:19:39.790537Z",
            "last_modified_time": "2023-08-16T05:19:39.790556Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "harjoittelu",
                "sv": "träning",
                "en": "training"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26412/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13449",
            "has_user_editable_resources": false,
            "alt_labels": [
                "teacher training schools",
                "normaalikoulut",
                "normaalilyseot",
                "normalskolor"
            ],
            "created_time": "2023-08-16T05:05:17.990999Z",
            "last_modified_time": "2023-08-16T05:05:17.991018Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "harjoittelukoulut",
                "sv": "övningsskolor",
                "en": "training schools"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13449/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2092",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:49.177764Z",
            "last_modified_time": "2023-08-16T05:16:49.177782Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "harjoittelupaikat",
                "sv": "praktikantplatser",
                "en": "traineeship posts"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2092/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28389",
            "has_user_editable_resources": false,
            "alt_labels": [
                "träningslokaler"
            ],
            "created_time": "2023-08-16T05:17:00.433842Z",
            "last_modified_time": "2023-08-16T05:17:00.433861Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "harjoittelutilat",
                "sv": "övningslokaler",
                "en": "rehearsal spaces"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28389/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13335",
            "has_user_editable_resources": false,
            "alt_labels": [
                "harjoitustehtävät",
                "träningar"
            ],
            "created_time": "2023-08-16T05:17:34.068123Z",
            "last_modified_time": "2023-08-16T05:17:34.068155Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "harjoitukset",
                "sv": "övningar",
                "en": "exercises"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13335/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}