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

{
    "meta": {
        "count": 31705,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1585&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1583&show_all_keywords=True"
    },
    "data": [
        {
            "id": "espoo_le:agggfz66i4",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.109319Z",
            "last_modified_time": "2023-12-13T11:20:12.109338Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 308,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Nöykkiö",
                "sv": "Nöykis",
                "en": "Nöykkiö"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz66i4/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz67dq",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.322308Z",
            "last_modified_time": "2023-12-13T11:20:12.322334Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 284,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Suurpelto",
                "sv": "Storåkern",
                "en": "Suurpelto"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz67dq/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz7aem",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.584781Z",
            "last_modified_time": "2023-12-13T11:20:12.584810Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 258,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Saunalahti",
                "sv": "Bastvik",
                "en": "Saunalahti"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz7aem/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz7ao4",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.668180Z",
            "last_modified_time": "2023-12-13T11:20:12.668197Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 241,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Haukilahti",
                "sv": "Gäddvik",
                "en": "Haukilahti"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz7ao4/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz67mm",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.393211Z",
            "last_modified_time": "2023-12-13T11:20:12.393233Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 208,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Kauklahti",
                "sv": "Köklax",
                "en": "Kauklahti"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz67mm/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz67zy",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.499844Z",
            "last_modified_time": "2023-12-13T11:20:12.499862Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 189,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Mankkaa",
                "sv": "Mankans",
                "en": "Mankkaa"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz67zy/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz7aqq",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.681933Z",
            "last_modified_time": "2023-12-13T11:20:12.681950Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 171,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Henttaa",
                "sv": "Hemtans",
                "en": "Henttaa"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz7aqq/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz65nu",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:11.890916Z",
            "last_modified_time": "2023-12-13T11:20:11.890936Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 163,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Karhusuo",
                "sv": "Björnkärr",
                "en": "Karhusuo"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz65nu/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz67oi",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.407707Z",
            "last_modified_time": "2023-12-13T11:20:12.407727Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 135,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Kera",
                "sv": "Kera",
                "en": "Kera"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz67oi/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz66dy",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.069264Z",
            "last_modified_time": "2023-12-13T11:20:12.069291Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 123,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Kalajärvi",
                "sv": "Kalajärvi",
                "en": "Kalajärvi"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz66dy/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz67wm",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.473201Z",
            "last_modified_time": "2023-12-13T11:20:12.473221Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 105,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Latokaski",
                "sv": "Ladusved",
                "en": "Latokaski"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz67wm/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz67uy",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.460688Z",
            "last_modified_time": "2023-12-13T11:20:12.460708Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 85,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Espoonkartano",
                "sv": "Esbogård",
                "en": "Espoonkartano"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz67uy/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz67p4",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.420717Z",
            "last_modified_time": "2023-12-13T11:20:12.420738Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 85,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Kurttila",
                "sv": "Kurtby",
                "en": "Kurttila"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz67p4/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz7aju",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.627675Z",
            "last_modified_time": "2023-12-13T11:20:12.627692Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 85,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Vanttila",
                "sv": "Fantsby",
                "en": "Vanttila"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz7aju/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz67rm",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.433142Z",
            "last_modified_time": "2023-12-13T11:20:12.433163Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 84,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Lahnus",
                "sv": "Lahnus",
                "en": "Lahnus"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz67rm/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz67ya",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.485958Z",
            "last_modified_time": "2023-12-13T11:20:12.485999Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 84,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Luukki",
                "sv": "Luk",
                "en": "Luukki"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz67ya/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz673u",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.515580Z",
            "last_modified_time": "2023-12-13T11:20:12.515597Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 75,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Niipperi",
                "sv": "Nipert",
                "en": "Niipperi"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz673u/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz652q",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:11.994101Z",
            "last_modified_time": "2023-12-13T11:20:11.994121Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 71,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Gumböle",
                "sv": "Gumböle",
                "en": "Gumböle"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz652q/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz656q",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.025448Z",
            "last_modified_time": "2023-12-13T11:20:12.025466Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 65,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Keilaniemi",
                "sv": "Kägeludden",
                "en": "Keilaniemi"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz656q/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "espoo_le:agggfz662q",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-12-13T11:20:12.249106Z",
            "last_modified_time": "2023-12-13T11:20:12.249122Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 64,
            "image": null,
            "data_source": "espoo_le",
            "publisher": null,
            "replaced_by": null,
            "name": {
                "fi": "Viherlaakso",
                "sv": "Gröndal",
                "en": "Viherlaakso"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/espoo_le:agggfz662q/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}