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": 31675,
        "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: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"
        },
        {
            "id": "yso:p19551",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:52.334542Z",
            "last_modified_time": "2023-08-16T05:09:52.334560Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fagotti",
                "sv": "fagott",
                "en": "bassoon"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19551/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5117",
            "has_user_editable_resources": false,
            "alt_labels": [
                "majolika",
                "majolika"
            ],
            "created_time": "2023-08-16T05:16:11.977355Z",
            "last_modified_time": "2023-08-16T05:16:11.977373Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fajanssi",
                "sv": "fajans",
                "en": "faience"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5117/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3849",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:15.723709Z",
            "last_modified_time": "2023-08-16T05:14:15.723727Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fajanssiteollisuus",
                "sv": "fajansindustri",
                "en": "faience industry"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3849/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28536",
            "has_user_editable_resources": false,
            "alt_labels": [
                "pseudo-folklore",
                "epäaito kansanperinne"
            ],
            "created_time": "2023-08-16T05:13:59.215109Z",
            "last_modified_time": "2023-08-16T05:13:59.215126Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "fakelore",
                "en": "fakelore"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28536/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16739",
            "has_user_editable_resources": false,
            "alt_labels": [
                "telefax",
                "telecopiers",
                "telefax machines",
                "telekopiolaitteet",
                "fax (apparater)",
                "faxapparater",
                "telefaxar",
                "telekopieringsapparater"
            ],
            "created_time": "2023-08-16T05:09:27.222843Z",
            "last_modified_time": "2023-08-16T05:09:27.222862Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "faksit",
                "sv": "telefaxapparater",
                "en": "fax machines"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16739/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29639",
            "has_user_editable_resources": false,
            "alt_labels": [
                "faktakontroll"
            ],
            "created_time": "2023-08-16T05:18:19.100436Z",
            "last_modified_time": "2023-08-16T05:18:19.100467Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "faktantarkistus",
                "sv": "faktagranskning",
                "en": "fact checking"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29639/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3055",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:56.583427Z",
            "last_modified_time": "2023-08-16T05:15:56.583446Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "faktatietokannat",
                "sv": "faktadatabaser",
                "en": "factual databases"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3055/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}