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

{
    "meta": {
        "count": 1327,
        "next": "https://api.tavastiaevents.fi/v1/keyword/?page=2",
        "previous": null
    },
    "data": [
        {
            "id": "yso:p2434",
            "alt_labels": [
                "ikä-ihmiset",
                "gamlingar",
                "ikäihmiset"
            ],
            "created_time": "2018-05-18T07:05:43.716000Z",
            "last_modified_time": "2018-05-18T07:05:43.716000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 4577,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "vanhukset",
                "sv": "åldringar",
                "en": "elderly"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p2434/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5590",
            "alt_labels": [
                "fullvuxna"
            ],
            "created_time": "2018-05-18T07:01:10.677000Z",
            "last_modified_time": "2018-05-18T07:01:10.677000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 3993,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aikuiset",
                "sv": "vuxna",
                "en": "adults"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p5590/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11617",
            "alt_labels": [
                "nuoriso",
                "teini-ikäiset",
                "unga"
            ],
            "created_time": "2018-05-18T07:04:45.998000Z",
            "last_modified_time": "2018-05-18T07:04:45.998000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 2814,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "nuoret",
                "sv": "ungdomar",
                "en": "young people"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p11617/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13050",
            "alt_labels": [],
            "created_time": "2018-05-18T07:05:41.659000Z",
            "last_modified_time": "2018-05-18T07:05:41.659000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 2800,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "lapsiperheet",
                "sv": "barnfamiljer",
                "en": "families with children"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p13050/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4363",
            "alt_labels": [
                "ydinperheet",
                "familjer"
            ],
            "created_time": "2018-05-18T07:05:10.136000Z",
            "last_modified_time": "2018-05-18T07:05:10.136000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 2795,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "perheet (ryhmät)",
                "sv": "familjer (grupper)",
                "en": "families (groups)"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p4363/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4354",
            "alt_labels": [
                "lapset",
                "barn"
            ],
            "created_time": "2018-05-18T07:06:25.308000Z",
            "last_modified_time": "2018-05-18T07:06:25.308000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 2794,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "lapset (ikäryhmät)",
                "sv": "barn (åldersgrupper)",
                "en": "children (age groups)"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p4354/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10699",
            "alt_labels": [
                "amatöörit",
                "harrastelijat",
                "enthusiasts",
                "hobbyists"
            ],
            "created_time": "2018-05-18T07:05:34.764000Z",
            "last_modified_time": "2018-05-18T07:05:34.764000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 2522,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "harrastajat",
                "sv": "amatörer (entusiaster)",
                "en": "amateurs (enthusiasts)"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p10699/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2901",
            "alt_labels": [
                "hobbyn",
                "harrasteet"
            ],
            "created_time": "2018-05-18T07:05:13.922000Z",
            "last_modified_time": "2018-05-18T07:05:13.922000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 2372,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "harrastukset",
                "sv": "hobbyer",
                "en": "hobbies"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p2901/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16486",
            "alt_labels": [],
            "created_time": "2018-05-18T07:02:31.502000Z",
            "last_modified_time": "2018-05-18T07:02:31.502000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 1816,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "opiskelijat",
                "sv": "studerande",
                "en": "students"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p16486/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2315",
            "alt_labels": [],
            "created_time": "2018-05-18T07:02:40.403000Z",
            "last_modified_time": "2018-05-18T07:02:40.403000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 1554,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "teatteritapahtumat",
                "sv": "teaterfestivaler",
                "en": "theatre events"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p2315/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1808",
            "alt_labels": [
                "musikkonst",
                "säveltaide"
            ],
            "created_time": "2018-05-18T07:01:16.484000Z",
            "last_modified_time": "2018-05-18T07:01:16.484000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 1412,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "musiikki",
                "sv": "musik",
                "en": "music"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p1808/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1393",
            "alt_labels": [
                "seurat -- järjestötoiminta",
                "yhdistykset"
            ],
            "created_time": "2018-05-18T07:06:15.431000Z",
            "last_modified_time": "2018-05-18T07:06:15.431000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 1308,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "järjestöt",
                "sv": "föreningar",
                "en": "associations"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p1393/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3128",
            "alt_labels": [
                "businesses",
                "affärsföretag",
                "liikeyritykset"
            ],
            "created_time": "2018-05-18T07:04:19.136000Z",
            "last_modified_time": "2018-05-18T07:04:19.136000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 1240,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "yritykset",
                "sv": "företag",
                "en": "enterprises"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p3128/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22036",
            "alt_labels": [
                "välbefinnande",
                "hyvinvointi (henkilökohtainen)"
            ],
            "created_time": "2018-05-18T07:07:00.111000Z",
            "last_modified_time": "2018-05-18T07:07:00.111000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 1231,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "hyvinvointi (terveydellinen)",
                "sv": "välmående",
                "en": "well-being"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p22036/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2762",
            "alt_labels": [],
            "created_time": "2018-05-18T07:05:03.105000Z",
            "last_modified_time": "2018-05-18T07:05:03.105000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 1229,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "terveys",
                "sv": "hälsa",
                "en": "health"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p2762/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1178",
            "alt_labels": [
                "privatföretagare",
                "egenföretagare",
                "yksityisyrittäjät"
            ],
            "created_time": "2018-05-18T07:05:30.463000Z",
            "last_modified_time": "2018-05-18T07:05:30.463000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 1194,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "yrittäjät",
                "sv": "företagare",
                "en": "entrepreneurs"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p1178/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3046",
            "alt_labels": [
                "tanssilajit"
            ],
            "created_time": "2018-05-18T07:04:01.128000Z",
            "last_modified_time": "2018-05-18T07:04:01.129000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 881,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tanssit",
                "sv": "danser",
                "en": "dances"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p3046/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1278",
            "alt_labels": [
                "tanssitaide",
                "danskonst"
            ],
            "created_time": "2018-05-18T07:06:13.358000Z",
            "last_modified_time": "2018-05-18T07:06:13.358000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 878,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tanssi",
                "sv": "dans",
                "en": "dance (performing arts)"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p1278/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5121",
            "alt_labels": [],
            "created_time": "2018-05-18T07:02:32.783000Z",
            "last_modified_time": "2018-05-18T07:02:32.783000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 829,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "näyttelyt",
                "sv": "utställningar",
                "en": "exhibitions"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p5121/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4934",
            "alt_labels": [
                "muséer"
            ],
            "created_time": "2018-05-18T07:03:23.356000Z",
            "last_modified_time": "2018-05-18T07:03:23.356000Z",
            "aggregate": false,
            "deprecated": false,
            "n_events": 794,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "museot",
                "sv": "museer",
                "en": "museums"
            },
            "@id": "https://api.tavastiaevents.fi/v1/keyword/yso:p4934/",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}