Keyword List List – Django REST framework

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=86&show_all_keywords=True

HTTP 200 OK
Allow: GET, POST, HEAD, OPTIONS
Content-Type: application/json ;utf-8
Vary: Accept

{
    "meta": {
        "count": 31684,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=87&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=85&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p7846",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:11.851645Z",
            "last_modified_time": "2023-08-16T05:12:11.851664Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "astiastot",
                "sv": "serviser",
                "en": "tableware"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7846/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6290",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:19:35.594226Z",
            "last_modified_time": "2023-08-16T05:19:35.594243Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "astiat",
                "sv": "kärl",
                "en": "dishes (household supplies)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6290/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19468",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:11.676745Z",
            "last_modified_time": "2023-08-16T05:06:11.676763Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "astma",
                "en": "asthma"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19468/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19307",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:10.123539Z",
            "last_modified_time": "2023-08-16T05:06:10.123556Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "astraaliuskonnot",
                "sv": "astralreligioner",
                "en": "astral religions"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19307/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29179",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:37.069690Z",
            "last_modified_time": "2024-10-30T04:40:18.056990Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Astraterra (peli)",
                "sv": "Astraterra (spel)",
                "en": "Astraterra (role-playing games)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29179/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19430",
            "has_user_editable_resources": false,
            "alt_labels": [
                "exobiology"
            ],
            "created_time": "2023-08-16T05:09:51.072921Z",
            "last_modified_time": "2023-08-16T05:09:51.072947Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "astrobiologia",
                "sv": "astrobiologi",
                "en": "astrobiology"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19430/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20188",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:26.746359Z",
            "last_modified_time": "2023-08-16T05:15:26.746386Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "astrofysiikka",
                "sv": "astrofysik",
                "en": "astrophysics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20188/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19206",
            "has_user_editable_resources": false,
            "alt_labels": [
                "cosmochemistry"
            ],
            "created_time": "2023-08-16T05:13:11.281635Z",
            "last_modified_time": "2023-08-16T05:13:11.281652Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "astrokemia",
                "sv": "astrokemi",
                "en": "astrochemistry"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19206/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7027",
            "has_user_editable_resources": false,
            "alt_labels": [
                "tähtimerkit",
                "stjärntecken",
                "tähdistä ennustaminen",
                "stjärntydning"
            ],
            "created_time": "2023-08-16T05:16:19.073455Z",
            "last_modified_time": "2023-08-16T05:16:19.073474Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "astrologia",
                "sv": "astrologi",
                "en": "astrology"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7027/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20379",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:22.795001Z",
            "last_modified_time": "2023-08-16T05:06:22.795027Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "astrologit",
                "sv": "astrologer",
                "en": "astrologers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20379/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4774",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:15.523900Z",
            "last_modified_time": "2023-08-16T05:08:15.523917Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "astrometria",
                "sv": "astrometri",
                "en": "astrometry"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4774/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19706",
            "has_user_editable_resources": false,
            "alt_labels": [
                "avaruuslentäjät",
                "kosmonautit",
                "kosmonauter",
                "rymdfarare",
                "rymdflygare",
                "taikonauter"
            ],
            "created_time": "2023-08-16T05:06:14.699457Z",
            "last_modified_time": "2023-08-16T05:06:14.699476Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "astronautit",
                "sv": "astronauter",
                "en": "astronauts"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19706/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26614",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:55.376074Z",
            "last_modified_time": "2023-08-16T05:10:55.376100Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "astrosytoomat",
                "sv": "astrocytom",
                "en": "astrocytomas"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26614/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25700",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:48.215547Z",
            "last_modified_time": "2023-08-16T05:10:48.215565Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "astrosyytit",
                "sv": "astrocyter",
                "en": "astrocytes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25700/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22316",
            "has_user_editable_resources": false,
            "alt_labels": [
                "astuttaminen"
            ],
            "created_time": "2023-08-16T05:10:16.975413Z",
            "last_modified_time": "2023-08-16T05:10:16.975443Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "astutus",
                "sv": "betäckning",
                "en": "service (biological methods)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22316/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9599",
            "has_user_editable_resources": false,
            "alt_labels": [
                "residential districts",
                "asuntoalueet"
            ],
            "created_time": "2023-08-16T05:18:59.956989Z",
            "last_modified_time": "2023-08-16T05:18:59.957007Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "asuinalueet",
                "sv": "bostadsområden",
                "en": "residential areas"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9599/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14303",
            "has_user_editable_resources": false,
            "alt_labels": [
                "boningsorter",
                "bosättningsorter"
            ],
            "created_time": "2023-08-16T05:12:46.154079Z",
            "last_modified_time": "2023-08-16T05:12:46.154098Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "asuinpaikat",
                "sv": "boplatser",
                "en": "places of residence"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14303/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38417",
            "has_user_editable_resources": false,
            "alt_labels": [
                "pit houses",
                "asumuspainanteet"
            ],
            "created_time": "2023-08-16T05:14:15.454162Z",
            "last_modified_time": "2023-08-16T05:14:15.454180Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "asuinpainanteet",
                "sv": "husgropar",
                "en": "housepits"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38417/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2074",
            "has_user_editable_resources": false,
            "alt_labels": [
                "asuintalot",
                "boningshus"
            ],
            "created_time": "2023-08-16T05:18:51.301686Z",
            "last_modified_time": "2023-08-16T05:18:51.301704Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "asuinrakennukset",
                "sv": "bostadshus",
                "en": "residential buildings"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2074/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13779",
            "has_user_editable_resources": false,
            "alt_labels": [
                "boendegemenskaper"
            ],
            "created_time": "2023-08-16T05:09:03.951671Z",
            "last_modified_time": "2023-08-16T05:09:03.951697Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "asuinyhteisöt",
                "sv": "bogemenskaper",
                "en": "housing communities"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13779/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}