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=155&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=156&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=154&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p29438",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:20.175780Z",
            "last_modified_time": "2024-01-17T04:40:45.713972Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Drottningholmin linna",
                "sv": "Drottningholms slott",
                "en": "Drottningholm palace"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29438/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20953",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:28.574686Z",
            "last_modified_time": "2023-08-16T05:15:28.574711Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "druidit",
                "sv": "druider",
                "en": "druids"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20953/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p30149",
            "has_user_editable_resources": false,
            "alt_labels": [
                "drum and bass",
                "drum'n'bass",
                "jungle",
                "drum 'n' bass",
                "drum and bass",
                "jungle"
            ],
            "created_time": "2023-08-16T05:17:49.132533Z",
            "last_modified_time": "2023-08-16T05:17:49.132550Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "drum 'n' bass",
                "sv": "drum'n'bass",
                "en": "drum 'n' bass"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30149/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38546",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Druses",
                "druusilaisuus",
                "drusism"
            ],
            "created_time": "2023-08-16T05:14:15.961153Z",
            "last_modified_time": "2023-08-16T05:14:15.961171Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "druusit",
                "sv": "druser",
                "en": "Druzes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38546/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38879",
            "has_user_editable_resources": false,
            "alt_labels": [
                "puunymfit",
                "trädnymfer"
            ],
            "created_time": "2023-08-16T05:08:00.244735Z",
            "last_modified_time": "2023-08-16T05:08:00.244756Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dryadit",
                "sv": "dryader",
                "en": "dryads"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38879/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14208",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:10.995812Z",
            "last_modified_time": "2023-08-16T05:15:10.995829Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dualismi",
                "sv": "dualism",
                "en": "dualism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14208/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20093",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:19.428568Z",
            "last_modified_time": "2023-08-16T05:06:19.428588Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "duathlon",
                "en": "duathlon"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20093/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p30069",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:25.764375Z",
            "last_modified_time": "2023-08-16T05:11:25.764395Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dub",
                "en": "dub"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30069/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29197",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Dublin Core (formaatti)",
                "Dublin Core (format)"
            ],
            "created_time": "2023-08-16T05:11:16.823773Z",
            "last_modified_time": "2023-08-16T05:11:16.823793Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Dublin Core",
                "en": "Dublin Core"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29197/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29943",
            "has_user_editable_resources": false,
            "alt_labels": [
                "dub step",
                "dub step",
                "dub step"
            ],
            "created_time": "2023-08-16T05:17:03.347224Z",
            "last_modified_time": "2023-08-16T05:17:03.347242Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dubstep",
                "en": "dubstep"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29943/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4380",
            "has_user_editable_resources": false,
            "alt_labels": [
                "företagsbesiktning"
            ],
            "created_time": "2023-08-16T05:14:27.673981Z",
            "last_modified_time": "2023-08-16T05:14:27.673999Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "due diligence",
                "en": "due diligence"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4380/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8007",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:45.866655Z",
            "last_modified_time": "2023-08-16T05:14:45.866673Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "duetot",
                "sv": "duetter",
                "en": "duets"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8007/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29807",
            "has_user_editable_resources": false,
            "alt_labels": [
                "cimbalom",
                "hammered dulcimer",
                "cimbalom",
                "czimbalom",
                "symbaali (dulcimer)"
            ],
            "created_time": "2023-08-16T05:07:42.229859Z",
            "last_modified_time": "2023-08-16T05:07:42.229876Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dulcimer",
                "sv": "hackbräde",
                "en": "dulcimer"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29807/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38475",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:55.529640Z",
            "last_modified_time": "2023-08-16T05:07:55.529659Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dungaanin kieli",
                "sv": "dunganska",
                "en": "Dungan language"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38475/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38338",
            "has_user_editable_resources": false,
            "alt_labels": [
                "tunganer"
            ],
            "created_time": "2023-08-16T05:07:54.291710Z",
            "last_modified_time": "2023-08-16T05:07:54.291738Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dungaanit",
                "sv": "dunganer",
                "en": "Dungans"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38338/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29818",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:55.158400Z",
            "last_modified_time": "2023-08-16T05:15:55.158419Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "duot (sävellykset)",
                "sv": "duor (kompositioner)",
                "en": "duets (compositions)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29818/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29815",
            "has_user_editable_resources": false,
            "alt_labels": [
                "musikduor"
            ],
            "created_time": "2023-08-16T05:07:42.301703Z",
            "last_modified_time": "2023-08-16T05:07:42.301720Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "duot (yhtyeet)",
                "sv": "duor (ensembler)",
                "en": "duos (ensembles)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29815/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29355",
            "has_user_editable_resources": false,
            "alt_labels": [
                "durra",
                "durror (släkte)"
            ],
            "created_time": "2023-08-16T05:14:02.928200Z",
            "last_modified_time": "2023-08-16T05:14:02.928216Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "durrat",
                "sv": "durrasläktet",
                "en": "Sorghum (genus)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29355/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12060",
            "has_user_editable_resources": false,
            "alt_labels": [
                "DVD-apparater"
            ],
            "created_time": "2023-08-16T05:08:51.765382Z",
            "last_modified_time": "2023-08-16T05:08:51.765399Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "DVD-laitteet",
                "sv": "dvd-apparater",
                "en": "DVD devices"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12060/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15917",
            "has_user_editable_resources": false,
            "alt_labels": [
                "DVD-audiolevyt",
                "DVD-äänilevyt",
                "digitaaliset videolevyt",
                "DVD-skivor",
                "digitala videoskivor",
                "dvd-audioskivor",
                "dvd-ljudskivor",
                "dvd:er"
            ],
            "created_time": "2023-08-16T05:12:54.547059Z",
            "last_modified_time": "2023-08-16T05:12:54.547077Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "DVD-levyt",
                "sv": "dvd-skivor",
                "en": "DVDs"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15917/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}