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=117&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=118&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=116&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p12288",
            "has_user_editable_resources": false,
            "alt_labels": [
                "biochemical markers",
                "biological markers",
                "markers",
                "biologiset markkerit",
                "biomerkkiaineet",
                "markkerit",
                "merkkiaineet (biomarkkerit)",
                "biokemiska markörer",
                "biologiska markörer",
                "markörer (biomarkörer)"
            ],
            "created_time": "2023-08-16T05:15:03.679609Z",
            "last_modified_time": "2023-08-16T05:15:03.679628Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "biomarkkerit",
                "sv": "biomarkörer",
                "en": "biomarkers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12288/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39245",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:20.176461Z",
            "last_modified_time": "2023-08-16T05:14:20.176479Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "biomassa (ekologia)",
                "sv": "biomassa (ekologi)",
                "en": "biomass (ecology)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39245/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6170",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:58.515205Z",
            "last_modified_time": "2023-08-16T05:17:58.515223Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "biomassa (teollisuus)",
                "sv": "biomassa (industri)",
                "en": "biomass (industry)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6170/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p711",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:00.323726Z",
            "last_modified_time": "2023-08-16T05:18:00.323745Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "biomateriaalit",
                "sv": "biomaterial",
                "en": "biomaterials"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p711/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20292",
            "has_user_editable_resources": false,
            "alt_labels": [
                "lihasmekaniikka",
                "muskelmekanik"
            ],
            "created_time": "2023-08-16T05:16:48.372971Z",
            "last_modified_time": "2023-08-16T05:16:48.372990Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "biomekaniikka",
                "sv": "biomekanik",
                "en": "biomechanics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20292/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39935",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:52.670925Z",
            "last_modified_time": "2023-08-16T05:11:52.670943Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "biometaani",
                "sv": "biometan",
                "en": "biomethane"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39935/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20567",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:01.445182Z",
            "last_modified_time": "2023-08-16T05:10:01.445199Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "biometeorologia",
                "sv": "biometeorologi",
                "en": "biometeorology"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20567/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21021",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:19.324083Z",
            "last_modified_time": "2023-08-16T05:13:19.324101Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "biomimeettiset materiaalit",
                "sv": "biomimetiskt material",
                "en": "biomimetic materials"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21021/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20872",
            "has_user_editable_resources": false,
            "alt_labels": [
                "eloyhteisöt",
                "biotiska regioner"
            ],
            "created_time": "2023-08-16T05:13:18.549581Z",
            "last_modified_time": "2023-08-16T05:13:18.549599Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "biomit",
                "sv": "biomer",
                "en": "biomes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20872/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27773",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:54.535659Z",
            "last_modified_time": "2023-08-16T05:13:54.535681Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "biomolekyylit",
                "sv": "biomolekyler",
                "en": "biomolecules"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27773/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7805",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:44.867335Z",
            "last_modified_time": "2023-08-16T05:14:44.867358Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "biomuovi",
                "sv": "bioplast",
                "en": "bioplastic"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7805/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22751",
            "has_user_editable_resources": false,
            "alt_labels": [
                "biomimetiikka",
                "biomimiikka",
                "biomimetik",
                "biomimik"
            ],
            "created_time": "2023-08-16T05:10:21.290557Z",
            "last_modified_time": "2023-08-16T05:10:21.290574Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "bioniikka",
                "sv": "bionik",
                "en": "bionics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22751/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1531",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:36.819575Z",
            "last_modified_time": "2023-08-16T05:17:36.819592Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "bio-oikeus",
                "sv": "biorätt",
                "en": "biolaw"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1531/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25269",
            "has_user_editable_resources": false,
            "alt_labels": [
                "biofeedback",
                "biofeedback-träning",
                "bioåterkoppling"
            ],
            "created_time": "2023-08-16T05:15:40.517703Z",
            "last_modified_time": "2023-08-16T05:15:40.517721Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "biopalaute",
                "sv": "biofeedback",
                "en": "biofeedback"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25269/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10731",
            "has_user_editable_resources": false,
            "alt_labels": [
                "kudospankit",
                "vävnadsbanker"
            ],
            "created_time": "2023-08-16T05:08:42.556695Z",
            "last_modified_time": "2023-08-16T05:08:42.556714Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "biopankit",
                "sv": "biobanker",
                "en": "biobanks"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10731/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18448",
            "has_user_editable_resources": false,
            "alt_labels": [
                "biostöld",
                "patent på liv"
            ],
            "created_time": "2023-08-16T05:13:07.887057Z",
            "last_modified_time": "2023-08-16T05:13:07.887073Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "biopiratismi",
                "sv": "biopiratism",
                "en": "biopiracy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18448/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23208",
            "has_user_editable_resources": false,
            "alt_labels": [
                "biovalta",
                "biomakt"
            ],
            "created_time": "2023-08-16T05:13:31.584192Z",
            "last_modified_time": "2023-08-16T05:13:31.584216Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "biopolitiikka",
                "sv": "biopolitik",
                "en": "biopolitics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23208/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3895",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:41.027132Z",
            "last_modified_time": "2023-08-16T05:18:41.027149Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "biopolttoaineet",
                "sv": "biobränslen",
                "en": "biofuels"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3895/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11414",
            "has_user_editable_resources": false,
            "alt_labels": [
                "luonnonpolymeerit",
                "naturpolymerer"
            ],
            "created_time": "2023-08-16T05:19:14.985011Z",
            "last_modified_time": "2023-08-16T05:19:14.985028Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "biopolymeerit",
                "sv": "biopolymerer",
                "en": "biopolymers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11414/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6704",
            "has_user_editable_resources": false,
            "alt_labels": [
                "koepalan otto",
                "kudosnäytteen otto",
                "vävnadsprov",
                "vävnadsprovtagning"
            ],
            "created_time": "2023-08-16T05:12:06.129142Z",
            "last_modified_time": "2023-08-16T05:12:06.129168Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "biopsia",
                "sv": "biopsi",
                "en": "biopsy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6704/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}