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

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

{
    "meta": {
        "count": 31988,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1256&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1254&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p18000",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:56.354624Z",
            "last_modified_time": "2023-08-16T05:05:56.354640Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "syntetismi",
                "sv": "syntetism",
                "en": "synthetism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18000/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5414",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:56.862666Z",
            "last_modified_time": "2023-08-16T05:18:56.862683Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "synti",
                "sv": "synd",
                "en": "sin"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5414/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25863",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:49.729812Z",
            "last_modified_time": "2023-08-16T05:10:49.729832Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "syntiinlankeemus",
                "sv": "syndafallet",
                "en": "Fall of man"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25863/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11908",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:07.739896Z",
            "last_modified_time": "2023-08-16T05:05:07.739915Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "SYNTYARD",
                "en": "SYNTYARD"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11908/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p37836",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:49.863511Z",
            "last_modified_time": "2023-08-16T05:07:49.863529Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "syntyhistoria (teokset)",
                "sv": "uppkomsthistoria (verk)",
                "en": "genesis (works)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p37836/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15340",
            "has_user_editable_resources": false,
            "alt_labels": [
                "foundational stories",
                "luomistarut",
                "ursprungsberättelser"
            ],
            "created_time": "2023-08-16T05:09:15.805528Z",
            "last_modified_time": "2023-08-16T05:09:15.805545Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "syntykertomukset",
                "sv": "ursprungsmyter",
                "en": "stories of origin"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15340/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13026",
            "has_user_editable_resources": false,
            "alt_labels": [
                "födelse"
            ],
            "created_time": "2023-08-16T05:08:58.555049Z",
            "last_modified_time": "2023-08-16T05:08:58.555067Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "syntymä",
                "sv": "födsel",
                "en": "birth"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13026/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23931",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:51.114673Z",
            "last_modified_time": "2023-08-16T05:06:51.114694Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "syntymäaika",
                "sv": "födelsetid",
                "en": "date of birth"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23931/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25962",
            "has_user_editable_resources": false,
            "alt_labels": [
                "födelseordning"
            ],
            "created_time": "2023-08-16T05:18:16.599630Z",
            "last_modified_time": "2023-08-16T05:18:16.599648Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "syntymäjärjestys",
                "sv": "plats i syskonskaran",
                "en": "birth order"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25962/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21394",
            "has_user_editable_resources": false,
            "alt_labels": [
                "synnyinmaa",
                "syntymävaltio"
            ],
            "created_time": "2023-08-16T05:15:30.159516Z",
            "last_modified_time": "2023-08-16T05:15:30.159534Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "syntymämaa",
                "sv": "födelseland",
                "en": "country of birth"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21394/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23532",
            "has_user_editable_resources": false,
            "alt_labels": [
                "place of birth",
                "synnyinseutu"
            ],
            "created_time": "2023-08-16T05:10:28.972682Z",
            "last_modified_time": "2023-08-16T05:10:28.972712Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "syntymäpaikka",
                "sv": "födelseort",
                "en": "birthplace"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23532/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21306",
            "has_user_editable_resources": false,
            "alt_labels": [
                "weight at birth"
            ],
            "created_time": "2023-08-16T05:16:50.014031Z",
            "last_modified_time": "2023-08-16T05:16:50.014049Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "syntymäpaino",
                "sv": "födelsevikt",
                "en": "birth weight"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21306/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38787",
            "has_user_editable_resources": false,
            "alt_labels": [
                "birth length"
            ],
            "created_time": "2023-08-16T05:18:21.312967Z",
            "last_modified_time": "2023-08-16T05:18:21.312985Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "syntymäpituus",
                "sv": "födelselängd",
                "en": "birth height"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38787/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20488",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:00.924287Z",
            "last_modified_time": "2023-08-16T05:10:00.924314Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "syntymäpäivät",
                "sv": "födelsedagar",
                "en": "birthdays"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20488/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8515",
            "has_user_editable_resources": false,
            "alt_labels": [
                "födselkontroll",
                "barnbegränsning",
                "befolkningskontroll (födelsekontroll)"
            ],
            "created_time": "2023-08-16T05:17:23.886469Z",
            "last_modified_time": "2023-08-16T05:17:23.886487Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "syntyvyyden säännöstely",
                "sv": "födelsekontroll",
                "en": "birth control"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8515/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11452",
            "has_user_editable_resources": false,
            "alt_labels": [
                "födelsetal"
            ],
            "created_time": "2023-08-16T05:16:34.071327Z",
            "last_modified_time": "2023-08-16T05:16:34.071348Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "syntyvyys",
                "sv": "nativitet",
                "en": "birth rate"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11452/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10032",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Cupressaceae"
            ],
            "created_time": "2023-08-16T05:08:37.629425Z",
            "last_modified_time": "2023-08-16T05:08:37.629450Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sypressikasvit",
                "sv": "cypressväxter",
                "en": "Cupressaceae"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10032/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38963",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Syringa",
                "sireenit (syreenit)",
                "syrener (släkte)"
            ],
            "created_time": "2023-08-16T05:11:43.479281Z",
            "last_modified_time": "2023-08-16T05:11:43.479301Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "syreenit",
                "sv": "syrensläktet",
                "en": "Syringa"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38963/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19916",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:17.247282Z",
            "last_modified_time": "2023-08-16T05:06:17.247314Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "syringomyelia",
                "sv": "syringomyeli",
                "en": "syringomyelia"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19916/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27398",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:17.304041Z",
            "last_modified_time": "2023-08-16T05:18:17.304057Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "syrjimättömyys",
                "sv": "icke-diskriminering",
                "en": "non-discrimination"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27398/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}