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=213&show_all_keywords=True
HTTP 200 OK
Allow: GET, POST, HEAD, OPTIONS
Content-Type: application/json ;utf-8
Vary: Accept

{
    "meta": {
        "count": 31745,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=214&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=212&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p19402",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Microsoft Excel",
                "Microsoft Excel"
            ],
            "created_time": "2023-08-16T05:06:11.004200Z",
            "last_modified_time": "2023-08-16T05:06:11.004217Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Excel",
                "en": "Excel"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19402/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6296",
            "has_user_editable_resources": false,
            "alt_labels": [
                "bookplates",
                "ex librikset",
                "bokägarmärken",
                "ex libris"
            ],
            "created_time": "2023-08-16T05:14:37.044601Z",
            "last_modified_time": "2023-08-16T05:14:37.044619Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "exlibrikset",
                "sv": "exlibris",
                "en": "ex librises"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6296/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24619",
            "has_user_editable_resources": false,
            "alt_labels": [
                "exotic (kissarotu)",
                "exotic (katt)",
                "exotic (kattras)"
            ],
            "created_time": "2023-08-16T05:10:38.723769Z",
            "last_modified_time": "2023-08-16T05:10:38.723787Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "exotic",
                "en": "exotic"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24619/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23106",
            "has_user_editable_resources": false,
            "alt_labels": [
                "ENP",
                "ENP"
            ],
            "created_time": "2023-08-16T05:10:24.860873Z",
            "last_modified_time": "2023-08-16T05:10:24.860892Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Expressive Notation Package",
                "en": "Expressive Notation Package"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23106/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28411",
            "has_user_editable_resources": false,
            "alt_labels": [
                "extreme run",
                "extreme-juoksu",
                "maastoestejuoksu",
                "extreme run"
            ],
            "created_time": "2023-08-16T05:07:30.006869Z",
            "last_modified_time": "2023-08-16T05:07:30.006893Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "extremejuoksu",
                "sv": "extremlöpning",
                "en": "extreme running"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28411/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11149",
            "has_user_editable_resources": false,
            "alt_labels": [
                "ekstreme-lajit",
                "ekstremelajit",
                "extremelajit",
                "äärilajit",
                "ääriurheilu",
                "extrema sporter"
            ],
            "created_time": "2023-08-16T05:08:45.269216Z",
            "last_modified_time": "2023-08-16T05:08:45.269235Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "extreme-lajit",
                "sv": "extremsporter",
                "en": "extreme sports"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11149/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12348",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:35.939735Z",
            "last_modified_time": "2023-08-16T05:12:35.939761Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "EY-oikeus",
                "sv": "EG-rätt",
                "en": "EC law"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12348/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15906",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:43.321401Z",
            "last_modified_time": "2023-08-16T05:16:43.321420Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "faabelit",
                "sv": "fabler",
                "en": "fables"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15906/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23358",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:27.354845Z",
            "last_modified_time": "2023-08-16T05:10:27.354870Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "faaraokoira",
                "sv": "faraohund",
                "en": "Pharaoh hound"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23358/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3000",
            "has_user_editable_resources": false,
            "alt_labels": [
                "faraot"
            ],
            "created_time": "2023-08-16T05:07:43.792878Z",
            "last_modified_time": "2023-08-16T05:07:43.792896Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "faaraot",
                "sv": "faraoner",
                "en": "pharaohs"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3000/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9335",
            "has_user_editable_resources": false,
            "alt_labels": [
                "faser (fysik och kemi)"
            ],
            "created_time": "2023-08-16T05:16:27.844561Z",
            "last_modified_time": "2023-08-16T05:16:27.844578Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "faasit",
                "sv": "faser (materia)",
                "en": "phases (chemistry)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9335/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28728",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:32.632604Z",
            "last_modified_time": "2023-08-16T05:07:32.632625Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fabliaut",
                "sv": "fabliau",
                "en": "fabliaux"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28728/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21586",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Anderson-Fabrys sjukdom"
            ],
            "created_time": "2023-08-16T05:06:31.177114Z",
            "last_modified_time": "2023-08-16T05:06:31.177136Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Fabryn tauti",
                "sv": "Fabrys sjukdom",
                "en": "Fabry's disease"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21586/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21063",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:19.746789Z",
            "last_modified_time": "2023-08-16T05:13:19.746811Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Facebook",
                "en": "Facebook"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21063/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3705",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:48.464331Z",
            "last_modified_time": "2023-08-16T05:07:48.464349Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "factoring",
                "en": "factoring (finance)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3705/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18243",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:40.066987Z",
            "last_modified_time": "2023-08-16T05:09:40.067010Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fadot",
                "sv": "fado",
                "en": "fados"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18243/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17385",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Fagervik",
                "Fagervik"
            ],
            "created_time": "2023-08-16T05:05:50.093529Z",
            "last_modified_time": "2023-08-16T05:05:50.093547Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Fagervikin kartano",
                "sv": "Fagervik gård",
                "en": "Fagervik manor"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17385/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29496",
            "has_user_editable_resources": false,
            "alt_labels": [
                "bakteriofagihoito",
                "faagiterapia",
                "bakteriofagbehandling"
            ],
            "created_time": "2023-08-16T05:14:04.050584Z",
            "last_modified_time": "2023-08-16T05:14:04.050611Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fagiterapia",
                "sv": "bakteriofagterapi",
                "en": "phage therapy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29496/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2811",
            "has_user_editable_resources": false,
            "alt_labels": [
                "syöjäsolutoiminta",
                "cellätande"
            ],
            "created_time": "2023-08-16T05:15:48.919336Z",
            "last_modified_time": "2023-08-16T05:15:48.919354Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fagosytoosi",
                "sv": "fagocytos",
                "en": "phagocytosis"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2811/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18404",
            "has_user_editable_resources": false,
            "alt_labels": [
                "fagottists"
            ],
            "created_time": "2023-08-16T05:09:41.426620Z",
            "last_modified_time": "2023-08-16T05:09:41.426636Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fagotistit",
                "sv": "fagottister",
                "en": "bassoonists"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18404/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}