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.

Keyword text

To find keywords that contain a specific string, use the query parameter text.

Example:

keyword/?text=lapset

See the result

Keyword source

Will restrict keywords to a specific data source.

Example:

keyword/?data_source=yso

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

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.

GET /v1/keyword/?page=3
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json ;utf-8
Vary: Accept

{
    "meta": {
        "count": 1343,
        "next": "https://api.tavastiaevents.fi/v1/keyword/?page=4",
        "previous": "https://api.tavastiaevents.fi/v1/keyword/?page=2"
    },
    "data": [
        {
            "id": "yso:p1780",
            "alt_labels": [],
            "created_time": "2018-05-18T07:02:23.498000Z",
            "last_modified_time": "2018-05-18T07:02:23.498000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 113,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "historia",
                "sv": "historia",
                "en": "history"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p1780/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2109",
            "alt_labels": [
                "publika tillfällen",
                "offentliga tillställningar",
                "yleisötapahtumat"
            ],
            "created_time": "2018-05-18T07:01:52.749000Z",
            "last_modified_time": "2018-05-18T07:01:52.749000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 105,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "yleisötilaisuudet",
                "sv": "evenemang för allmänheten",
                "en": "public events"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p2109/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2108",
            "alt_labels": [
                "incidents"
            ],
            "created_time": "2018-05-18T07:03:56.984000Z",
            "last_modified_time": "2018-05-18T07:03:56.984000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 104,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tapahtumat",
                "sv": "händelser",
                "en": "events"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p2108/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27962",
            "alt_labels": [
                "livemusik",
                "livemusiikki"
            ],
            "created_time": "2018-05-18T07:05:03.648000Z",
            "last_modified_time": "2018-05-18T07:05:03.648000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 97,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "elävä musiikki",
                "sv": "levande musik",
                "en": "live music"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p27962/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8567",
            "alt_labels": [
                "digital teknik",
                "digitekniikka"
            ],
            "created_time": "2018-05-18T07:05:01.385000Z",
            "last_modified_time": "2018-05-18T07:05:01.385000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 89,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "digitaalitekniikka",
                "sv": "digitalteknik",
                "en": "digital technology"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p8567/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7071",
            "alt_labels": [
                "maastoliikunta"
            ],
            "created_time": "2018-05-18T07:03:54.559000Z",
            "last_modified_time": "2018-05-18T07:03:54.559000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 89,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "luontoliikunta",
                "sv": "friluftsmotion",
                "en": "outdoor exercise in nature"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p7071/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8113",
            "alt_labels": [
                "kirjallisuus (taidelajit)"
            ],
            "created_time": "2018-05-18T07:04:51.381000Z",
            "last_modified_time": "2018-05-18T07:04:51.381000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 84,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "kirjallisuus",
                "sv": "litteratur",
                "en": "literature"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p8113/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6889",
            "alt_labels": [],
            "created_time": "2018-05-18T07:01:36.453000Z",
            "last_modified_time": "2018-05-18T07:01:36.453000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 72,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "taidenäyttelyt",
                "sv": "konstutställningar",
                "en": "art exhibitions"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p6889/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8631",
            "alt_labels": [
                "hobbyverksamhet"
            ],
            "created_time": "2018-05-18T07:05:21.545000Z",
            "last_modified_time": "2018-05-18T07:05:21.545000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 64,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "askartelu",
                "sv": "pyssel",
                "en": "hobby crafting"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p8631/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2851",
            "alt_labels": [
                "taide (erikoisala)"
            ],
            "created_time": "2018-05-18T07:04:39.079000Z",
            "last_modified_time": "2018-05-18T07:04:39.079000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 62,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "taide",
                "sv": "konst",
                "en": "art"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p2851/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18452",
            "alt_labels": [],
            "created_time": "2018-05-18T07:06:50.042000Z",
            "last_modified_time": "2018-05-18T07:06:50.042000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 61,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "kulttuurihistoria",
                "sv": "kulturhistoria",
                "en": "cultural history"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p18452/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11185",
            "alt_labels": [
                "konserter (evenemang)",
                "live-konsertit",
                "konserter"
            ],
            "created_time": "2018-05-18T07:01:48.621000Z",
            "last_modified_time": "2018-05-18T07:01:48.621000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 57,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "konsertit",
                "sv": "konserter (framträdanden)",
                "en": "concerts"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p11185/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18003",
            "alt_labels": [],
            "created_time": "2018-05-18T07:02:52.872000Z",
            "last_modified_time": "2018-05-18T07:02:52.872000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 57,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "kulttuuriharrastukset",
                "sv": "kulturella intressen",
                "en": "cultural hobbies"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p18003/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6787",
            "alt_labels": [
                "datamaskiner",
                "pientietokoneet",
                "minidatorer"
            ],
            "created_time": "2018-05-18T07:04:19.735000Z",
            "last_modified_time": "2018-05-18T07:04:19.735000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 55,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tietokoneet",
                "sv": "datorer",
                "en": "computers"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p6787/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27974",
            "alt_labels": [
                "julgåvor"
            ],
            "created_time": "2018-05-18T07:01:53.584000Z",
            "last_modified_time": "2018-05-18T07:01:53.584000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 54,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "joululahjat",
                "sv": "julklappar",
                "en": "Christmas presents"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p27974/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6044",
            "alt_labels": [
                "gallerier",
                "galleriat"
            ],
            "created_time": "2018-05-18T07:01:23.222000Z",
            "last_modified_time": "2018-05-18T07:01:23.222000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 52,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "taidegalleriat",
                "sv": "konstgallerier",
                "en": "art galleries"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p6044/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26925",
            "alt_labels": [],
            "created_time": "2018-05-18T07:01:35.477000Z",
            "last_modified_time": "2018-05-18T07:01:35.477000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 49,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aineeton kulttuuriperintö",
                "sv": "immateriellt kulturarv",
                "en": "intangible cultural heritage"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p26925/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2431",
            "alt_labels": [
                "pensionstagare"
            ],
            "created_time": "2018-05-18T07:06:34.381000Z",
            "last_modified_time": "2018-05-18T07:06:34.381000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 47,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "eläkeläiset",
                "sv": "pensionärer",
                "en": "pensioners"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p2431/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11514",
            "alt_labels": [
                "cafeer",
                "cafeterior",
                "coffeehouses",
                "coffee shops",
                "kahviot",
                "caféer"
            ],
            "created_time": "2018-05-18T07:01:24.405000Z",
            "last_modified_time": "2018-05-18T07:01:24.405000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 46,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "kahvilat",
                "sv": "kaféer",
                "en": "cafés"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p11514/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23821",
            "alt_labels": [
                "smartmobiler"
            ],
            "created_time": "2018-05-18T07:02:36.305000Z",
            "last_modified_time": "2018-05-18T07:02:36.305000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 44,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "älypuhelimet",
                "sv": "smarttelefoner",
                "en": "smartphones"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p23821/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}