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

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

{
    "meta": {
        "count": 31947,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1388&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1386&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p22446",
            "has_user_editable_resources": false,
            "alt_labels": [
                "tjejarbete"
            ],
            "created_time": "2023-08-16T05:06:37.226396Z",
            "last_modified_time": "2023-08-16T05:06:37.226417Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tyttötyö",
                "sv": "flickarbete",
                "en": "girl work"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22446/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24107",
            "has_user_editable_resources": false,
            "alt_labels": [
                "flickidentitet",
                "flicktid",
                "flickålder"
            ],
            "created_time": "2023-08-16T05:15:37.590048Z",
            "last_modified_time": "2023-08-16T05:15:37.590067Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tyttöys",
                "sv": "flickskap",
                "en": "girlhood"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24107/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27391",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:57.958740Z",
            "last_modified_time": "2023-08-16T05:16:57.958760Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tyttöystävät",
                "sv": "flickvänner",
                "en": "girlfriends"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27391/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13599",
            "has_user_editable_resources": false,
            "alt_labels": [
                "sisaryhtiöt",
                "systerbolag"
            ],
            "created_time": "2023-08-16T05:12:42.352349Z",
            "last_modified_time": "2023-08-16T05:12:42.352366Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tytäryhtiöt",
                "sv": "dotterbolag",
                "en": "subsidiary companies"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13599/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28146",
            "has_user_editable_resources": false,
            "alt_labels": [
                "smalflicksländor",
                "sommarflicksländor"
            ],
            "created_time": "2023-08-16T05:11:08.319119Z",
            "last_modified_time": "2023-08-16T05:11:08.319137Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tytönkorennot",
                "sv": "dammflicksländor",
                "en": "Coenagrionidae"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28146/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7196",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:19.756087Z",
            "last_modified_time": "2023-08-16T05:17:19.756106Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tytöt",
                "sv": "flickor",
                "en": "girls"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7196/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16695",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:59.080686Z",
            "last_modified_time": "2023-08-16T05:12:59.080705Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tyvimätä",
                "sv": "stjälkbakterios",
                "en": "black leg (plant diseases)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16695/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21782",
            "has_user_editable_resources": false,
            "alt_labels": [
                "basaliooma",
                "basalcellcancer"
            ],
            "created_time": "2023-08-16T05:06:32.757313Z",
            "last_modified_time": "2023-08-16T05:06:32.757337Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tyvisolusyöpä",
                "sv": "basaliom",
                "en": "basal cell carcinoma"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21782/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24617",
            "has_user_editable_resources": false,
            "alt_labels": [
                "basalganglier"
            ],
            "created_time": "2023-08-16T05:10:38.648185Z",
            "last_modified_time": "2023-08-16T05:10:38.648335Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tyvitumakkeet",
                "sv": "basala ganglier",
                "en": "basal ganglia"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24617/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7863",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:12.021786Z",
            "last_modified_time": "2023-08-16T05:12:12.021805Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tyylihuonekalut",
                "sv": "stilmöbler",
                "en": "period furniture"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7863/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1784",
            "has_user_editable_resources": false,
            "alt_labels": [
                "tyylisuunnat",
                "stilriktningar"
            ],
            "created_time": "2023-08-16T05:15:21.963225Z",
            "last_modified_time": "2023-08-16T05:15:21.963243Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tyylikaudet",
                "sv": "stilperioder",
                "en": "stylistic periods"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1784/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4952",
            "has_user_editable_resources": false,
            "alt_labels": [
                "stilistiikka"
            ],
            "created_time": "2023-08-16T05:14:30.495519Z",
            "last_modified_time": "2023-08-16T05:14:30.495536Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tyylintutkimus",
                "sv": "stilforskning",
                "en": "stylistic research"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4952/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26297",
            "has_user_editable_resources": false,
            "alt_labels": [
                "stilistiikka",
                "stillära"
            ],
            "created_time": "2023-08-16T05:13:46.342123Z",
            "last_modified_time": "2023-08-16T05:13:46.342140Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tyylioppi",
                "sv": "stilistik",
                "en": "stylistics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26297/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p421",
            "has_user_editable_resources": false,
            "alt_labels": [
                "stil",
                "tyylisuunnat",
                "stilriktningar",
                "tyyli"
            ],
            "created_time": "2023-08-16T05:19:48.562208Z",
            "last_modified_time": "2023-08-16T05:19:48.562226Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tyylit",
                "sv": "stilar",
                "en": "styles (phenomena)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p421/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38620",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Micarea"
            ],
            "created_time": "2023-08-16T05:11:39.502464Z",
            "last_modified_time": "2023-08-16T05:11:39.502482Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tyynyjäkälät",
                "sv": "dynlavar",
                "en": "Micarea"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38620/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15497",
            "has_user_editable_resources": false,
            "alt_labels": [
                "dynor"
            ],
            "created_time": "2023-08-16T05:12:52.636874Z",
            "last_modified_time": "2023-08-16T05:12:52.636893Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tyynyt",
                "sv": "kuddar",
                "en": "pillows"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15497/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20366",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:59.635735Z",
            "last_modified_time": "2023-08-16T05:09:59.635757Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tyyppihyväksyntä",
                "sv": "typgodkännande",
                "en": "type approval"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20366/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28639",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:11.986332Z",
            "last_modified_time": "2023-08-16T05:11:11.986350Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tyyppiluettelot",
                "sv": "typkataloger",
                "en": "type indexes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28639/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22543",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:33.569097Z",
            "last_modified_time": "2023-08-16T05:15:33.569115Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tyyppitalot",
                "sv": "typhus",
                "en": "type-planned houses"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22543/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21127",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:20.244865Z",
            "last_modified_time": "2023-08-16T05:13:20.244883Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tyytymättömyys",
                "sv": "missnöje",
                "en": "dissatisfaction"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21127/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}