This repository is a freely accessible dataset that contains information about the participants and votes of all editions of the Eurovision Song Contest and Junior Eurovision Song Contest.
Every year the dataset will be updated with the results of the contest, from the first edition in 1956 to the present. For Junior Eurovision, the first edition was in 2003.
The data is obtained from the ESC Home, Eurovision World, Eurovision LOD, Logopedia and Ogaespain websites.
You can see the dataset information on this web page.
The dataset can be downloaded here or from the dataset folder.
The dataset is in JSON format.
A dictionary of strings with the relationship between the codes and the names of the countries that have ever participated in the contest.
An array of Contest representing all the editions of the contest.
It represents an annual edition.
| Attribute | Type | Description |
|---|---|---|
| year | integer | Year in which the contest was held |
| arena | string | Building where the contest was held |
| city | string | Host city |
| country | string | Host country code |
| intendedCountry | string | If not null stores the code of the country that should have been the host but couldn't (Ukraine 2023) |
| slogan | string | Slogan of the contest |
| logoUrl | string | Link to contest thumbnail |
| voting | string | Information about the voting system |
| presenters | string[] | Presenters of the edition |
| broadcasters | string[] | Host broadcasters of the contest |
| contestants | Contestant[] | All contestants of the contest |
| rounds | Round[] | All rounds of the contest |
It represents each of the contestant songs of the edition.
| Attribute | Type | Description |
|---|---|---|
| id | integer | Contestant ID (used in Performance ) |
| country | string | Code of the country that is represented |
| artist | string | Name of the singer/group performing |
| song | string | Song title |
| lyrics | Lyrics[] | All lyrics of the song with translations (in the corresponding language). The first lyrics is the original. |
| videoUrl | string[] | All links to a Youtube videos showing the song |
| tone | string | Key and scale of the song |
| bpm | integer | Beats per minute of the song |
| dancers | string[] | Song dancers |
| backings | string[] | Song backings |
| jury | string[] | Jury in song selection |
| composers | string[] | Song composers |
| lyricists | string[] | Song lyricists |
| writers | string[] | Song writers |
| conductor | string | Song conductor |
| stageDirector | string | Song stage director |
| broadcaster | string | Candidate country broadcaster |
| spokesperson | string | Candidate country spokesperson |
| commentators | string[] | Candidate country commentators |
It represents the original lyrics of the song and each of the translations of the lyrics (indicating their languages).
| Attribute | Type | Description |
|---|---|---|
| languages | string[] | All languages that contains the song lyrics |
| title | string | The song title |
| content | string | The song lyrics, paragraphs are separated by double line break ("\n\n") |
| Attribute | Type | Description |
|---|---|---|
| name | string | Round name (final, semifinal if the year is between 2004 and 2007, semifinal1 or semifinal2 if the year is greater than 2007 ) |
| date | string | Date when the round was held in UTC |
| time | string | Time when the round was held in UTC |
| performances | Performance[] | Results of the performances of the contestants in this round |
| disqualifieds | int[] | The id of the contestants who have been disqualified in the round |
| Attribute | Type | Description |
|---|---|---|
| contestantId | integer | Contestant ID |
| running | integer | Place on the running |
| place | integer | Place in the ranking |
| scores | Score[] | Score and voting |
| Attribute | Type | Description |
|---|---|---|
| name | string | Origin of points (total, tele and jury if the year is greater than 2015) |
| points | integer | Total points earned |
| votes | Dictionary<string, integer> | Votes received from each country (using the country code) |
An array of Contest representing all the editions of the junior contest.
It represents an annual edition.
| Attribute | Type | Description |
|---|---|---|
| year | integer | Year in which the contest was held |
| arena | string | Building where the contest was held |
| city | string | Host city |
| country | string | Host country code |
| slogan | string | Slogan of the contest |
| logoUrl | string | Link to contest thumbnail |
| voting | string | Information about the voting system |
| presenters | string[] | Presenters of the edition |
| contestants | Contestant[] | All contestants of the contest |
| rounds | Round[] | All rounds of the contest |
It represents each of the contestant songs of the edition.
| Attribute | Type | Description |
|---|---|---|
| id | integer | Contestant ID (used in Performance ) |
| country | string | Code of the country that is represented |
| artist | string | Name of the singer/group performing |
| song | string | Song title |
| lyrics | Lyrics[] | All lyrics of the song with translations (in the corresponding language). The first lyrics is the original. |
| videoUrl | string[] | All links to a Youtube videos showing the song |
| dancers | string[] | Song dancers |
| backings | string[] | Song backings |
| composers | string[] | Song composers |
| lyricists | string[] | Song lyricists |
| writers | string[] | Song writers |
It represents the original lyrics of the song and each of the translations of the lyrics (indicating their languages).
| Attribute | Type | Description |
|---|---|---|
| languages | string[] | All languages that contains the song lyrics |
| title | string | The song title |
| content | string | The song lyrics, paragraphs are separated by double line break ("\n\n") |
| Attribute | Type | Description |
|---|---|---|
| name | string | Round name (finals only for now) |
| date | string | Date when the round was held in UTC |
| time | string | Time when the round was held in UTC |
| performances | Performance[] | Results of the performances of the contestants in this round |
| Attribute | Type | Description |
|---|---|---|
| contestantId | integer | Contestant ID |
| running | integer | Place on the running |
| place | integer | Place in the ranking |
| scores | Score[] | Score and voting |
| Attribute | Type | Description |
|---|---|---|
| name | string | Origin of points (total, nationals, online, kids, etc.) |
| points | integer | Points earned |