{apis.is}

Our purpose is to make data readily available to anyone interested

Would you like to suggest a new endpoint to be implemented?
Don't hesitate to contact us, or contribute to our github repository.

What the..?

API stands for 'Application Programming Interface', literally specifying how software components should interact with each other. In our context, this means we have endpoints that return different kinds of data to developers using JSON objects, allowing them to use and manipulate it for their own applications.

Bottom line is; this service creates a lot of opportunities for developers that don't necessarily have the know-how, time or resources to get the data themselves, but are full of ideas for using it. So if you have an idea that only needs a little more data to become a reality, don't hesitate to contact us or even contribute yourself to our github repository.

How does it all work?

Our servers scrape various websites for the desired information. For more detailed information on individual endpoints visit our github repository and look at the source code.

How to get started?

This documentation includes simple jQuery.ajax demos. Feel free to copy these to your projects, but remember that they are provided as is, and you will most certainly have to adjust them to your own needs.

What about version control?

At the moment, including an accept-version header is not necessary, since all endpoints are at version 1, but we strongly recommend it, especially in production environments. Once an endpoint has been updated, the default version to be returned is the most recent, and this documentation will be updated accordingly. Changes in functionality between versions will be outlisted.

How is all this possible? And for free?

APIs.is is completely open source and developed by several contributors working on their own personal time. All this runs in the cloud, available to you at all times.

Icelandic Addresses

Source: Iceland Post

get /address

Lookup addresses in Iceland through the Icelandic Post API

Parameters
address
Valid address
jQuery demo
$.ajax({
  'url': 'http://apis.is/address',
  'type': 'GET',
  'dataType': 'json',
  'data': {'address': 'laugavegur 1'},
  'success': function(response) {
    console.log(response);
  }
});
Response
{
  "results": [
    {
      "street": "laugavegur",
      "house": 1,
      "zip": "101",
      "city": "Reykjavík",
      "apartment": "",
      "letter": ""
    }
  ]
}

Icelandic Bus System

Source: bus.is

get /bus/realtime

Real-time location of busses. Results are only shown for active busses.

Parameters
busses
Comma seperated list of numbers. Good to know: If not declared, the endpoint will return location of all available busses.
jQuery demo
$.ajax({
  'url': 'http://apis.is/bus/realtime',
  'type': 'GET',
  'dataType': 'json',
  'data': {'busses': '1,5'},
  'success': function(response) {
    console.log(response);
  }
});
Response
{
    "results": [
        {
            "busNr": "1",
            "busses": [
                {
                    "unixTime": 1354618575,
                    "x": 64.090668,
                    "y": -21.92904,
                    "from": "Hlemmur",
                    "to": "Klukkuvellir"
                },
                {
                    "unixTime": 1354618575,
                    "x": 64.086315,
                    "y": -21.937813,
                    "from": "Klukkuvellir",
                    "to": "Hlemmur"
                }
            ]
        },
        {
            "busNr": "5",
            "busses": [
                {
                    "unixTime": 1354618563,
                    "x": 64.135644,
                    "y": -21.850126,
                    "from": "Hlemmur",
                    "to": "Elliðabraut / Árvað"
                },
                {
                    "unixTime": 1354618577,
                    "x": 64.143989,
                    "y": -21.913048,
                    "from": "Elliðabraut / Árvað",
                    "to": "Hlemmur"
                }
            ]
        }
    ]
}

Cars in Iceland

Source: The Road Traffic Directorate

get /car?number=aa031

Search the icelandic vehicle registry

Parameters
number
Registry number
jQuery demo
$.ajax({
  'url': 'http://apis.is/car',
  'type': 'GET',
  'dataType': 'json',
  'data': {'number': 'aa031'},
  'success': function(response) {
    console.log(response);
  }
});
Response
{
    "results": [
        {
            "registryNumber": "AA031",
            "number": "AA031",
            "factoryNumber": "VF37ENFZE32286866",
            "type": "PEUGEOT",
            "subType": "306",
            "color": "Blár",
            "registeredAt": "26.02.1998",
            "status": "Í lagi",
            "nextCheck": "01.01.2013",
            "pollution": "",
            "weight": "1120"
        }
    ]
}

Icelandic companies

Source: Directorate of Internal Revenue in Iceland

get /company?name=blendin

Search the icelandic company registry
NB: At least one parameter is required.

Parameters
name
Company name
address
Company's address
socialnumber
Company's social security number / ID number
vsknr
Company's VAT-number (VSK in icelandic)
jQuery demo
$.ajax({
  'url': 'http://apis.is/company',
  'type': 'GET',
  'dataType': 'json',
  'data': {'name': 'blendin'},
  'success': function(response) {
    console.log(response);
  }
});
Response
{
  "results": [
    {
      "name": "Blendin ehf.",
      "sn": "6304141720",
      "active": 1,
      "address": "Hamrahlíð 9  105 Reykjavík"
    }
  ]
}

Concerts in Iceland

Source: midi.is

get /concerts

Get a list of all the concerts in Iceland sorted by date

No parameters available
jQuery demo
$.ajax({
  'url': 'http://apis.is/concerts',
  'type': 'GET',
  'dataType': 'json',
  'success': function(response) {
    console.log(response);
  }
});
Response
{
  "results": [
    {
      "eventDateName": "Vínartónleikar 2015",
      "name": "Græn - tónleikaröð",
      "dateOfShow": "2015-01-08T19:30:00",
      "userGroupName": "Harpa",
      "eventHallName": "Eldborg                                           ",
      "imageSource": "http://midi.is/images/medium/15.759.jpg"
    },
    {
      "eventDateName": "Föstudagsfreistingar 09.01",
      "name": "",
      "dateOfShow": "2015-01-09T12:00:00",
      "userGroupName": "Miðasala MAk",
      "eventHallName": "Hamrar                                            ",
      "imageSource": "http://midi.is/images/medium/1.8394.jpg"
    }
  ]
}

Currency in relation to ISK

Sources: m5.isArion banki and Landsbankinn

get /currency/:source

Get currency data in relation to ISK

Parameters
/:source
Which source to use (m5|arion|lb)
jQuery demo
$.ajax({
  'url': 'http://apis.is/currency/m5',
  'type': 'GET',
  'dataType': 'json',
  'success': function(response) {
    console.log(response);
  }
});
Response (m5)
{
  "results": [
    {
      "shortName": "USD",
      "longName": "Bandarískur dalur",
      "value": 121.53,
      "askValue": 0,
      "bidValue": 0,
      "changeCur": 0.055,
      "changePer": 0.05
    },
    {
      "shortName": "EUR",
      "longName": "Evra",
      "value": 162.2,
      "askValue": 0,
      "bidValue": 0,
      "changeCur": 0.015,
      "changePer": 0.01
    }
  ]
}
Response (arion)
{
  "results": [
    {
      "shortName": "USD",
      "longName": "Bandarískur dalur",
      "value": 121.515,
      "askValue": 121.88,
      "bidValue": 121.15,
      "changeCur": -0.40857,
      "changePer": 0
    },
    {
      "shortName": "EUR",
      "longName": "Evra",
      "value": 162.185,
      "askValue": 162.67,
      "bidValue": 161.7,
      "changeCur": 0.09845,
      "changePer": "0.00"
    }
  ]
}
Response (lb)
{
  "results": [
    {
      "shortName": "USD",
      "longName": "Bandaríkjadalur",
      "value": 121.47,
      "askValue": 121.83,
      "bidValue": 121.11,
      "changeCur": 0.01,
      "changePer": 0
    },
    {
      "shortName": "EUR",
      "longName": "Evra",
      "value": 162.3,
      "askValue": 162.78,
      "bidValue": 161.82,
      "changeCur": 0.09,
      "changePer": 0
    }
  ]
}

Bicyclecounter in Reykjavik

Source: Bicycle Counter

get /cyclecounter

Get current status of bicycle counters in Iceland, currently only one located by Sudurlandsbraut in Reykjavik.

No parameters available
jQuery demo
$.ajax({
  'url': 'http://apis.is/cyclecounter',
  'type': 'GET',
  'dataType': 'json',
  'success': function(response) {
    console.log(response);
  }
});
Response
{
  "results": [
    {
      "DayCount": "154",
      "YearCount": "31853",
      "Time": "16:48",
      "Date": "18. Sep 2013"
    }
  ]
}

Earthquakes in Iceland

Source: Icelandic Meteorological Office

get /earthquake/is

Get earthquake monitoring data for the last 48 hours.

No parameters available
jQuery demo
$.ajax({
  'url': 'http://apis.is/earthquake/is',
  'type': 'GET',
  'dataType': 'json',
  'success': function(response) {
    console.log(response);
  }
});
Response
{
  "results": [
    {
      "timestamp": "2013-09-17T10:35:46.000Z",
      "latitude": 66.181,
      "longitude": -17.764,
      "depth": 11.3,
      "size": 0.9,
      "quality": 54.02,
      "humanReadableLocation": "3,8 km ANA af Flatey"
    },
    {
      "timestamp": "2013-09-17T04:52:13.000Z",
      "latitude": 63.684,
      "longitude": -19.282,
      "depth": 4.7,
      "size": 1.7,
      "quality": 35.9,
      "humanReadableLocation": "5,1 km NNV af Goðabungu"
    }
  ]
}

International flights in Iceland

Source: Keflavik Airport

get /flight?language=en&type=departures

Get a list of all international flights departing and arriving at Keflavik Airport today.

Parameters
language
'en' or 'is'
type
'departures' or 'arrivals'
jQuery demo
$.ajax({
  'url': 'http://apis.is/flight',
  'type': 'GET',
  'dataType': 'json',
  'data': {'language': 'en', 'type': 'departures'},
  'success': function(response) {
    console.log(response);
  }
});
Response
{
    "results": [
        {
            "date": "26. Jan",
            "flightNumber": "FI671",
            "to": "Denver Intl",
            "plannedArrival": "17:00",
            "realArrival": "17:23",
            "status": "Departed 17:12"
        },
        {
            "date": "26. Jan",
            "flightNumber": "FI615",
            "to": "New York JFK",
            "plannedArrival": "17:05",
            "realArrival": "17:26",
            "status": "Departed 17:17"
        }
    ]
}

Status of icelandic hospitals

Source: The National University Hospital of Iceland

get /hospital

Get the current status of the National University Hospital of Iceland.

No parameters available
jQuery demo
$.ajax({
  'url': 'http://apis.is/hospital',
  'type': 'GET',
  'dataType': 'json',
  'data': {},
  'success': function(response) {
    console.log(response);
  }
});
Response
{
  "results": [
    {
      "birthNumbers": 2,
      "surgeries": 3,
      "dischargedNumbers": 2,
      "hospitalizedNumbers": 15,
      "atwork": 2193,
      "patients-child": 13,
      "patients-er": 25,
      "patients-walk": 17,
      "patients-icu": 15,
      "patients-hotel": 33,
      "donors": 3,
      "patients-skilun": 7,
      "patients-heart2": 3
    }
  ]
}

Icelandic lottery

Source: lotto.is

get /lottery

Get the most recent numbers for the icelandic lottery.

No parameters available
jQuery demo
$.ajax({
  'url': 'http://apis.is/lottery',
  'type': 'GET',
  'dataType': 'json',
  'success': function(response) {
    console.log(response);
  }
});
Response
{
  "results": [
    {
      "date": "14.09.2013",
      "lotto": "13 14 28 37 39 (29)",
      "joker": "0 7 6 6 9",
      "prize": "6.091.360 kr.",
      "link": "http://lotto.is/lottoleikir/urslit/lotto?_date=14.09.2013"
    },
    {
      "date": "07.09.2013",
      "lotto": "10 15 34 35 39 (27)",
      "joker": "6 5 1 7 4",
      "prize": "13.287.850 kr.",
      "link": "http://lotto.is/lottoleikir/urslit/lotto?_date=07.09.2013"
    }
  ]
}
get /lottery/vikingalotto

Get the most recent numbers for Vikingalotto.

No parameters available
jQuery demo
$.ajax({
  'url': 'http://apis.is/lottery/vikingalotto',
  'type': 'GET',
  'dataType': 'json',
  'success': function(response) {
    console.log(response);
  }
});
Response
{
  "results": [
    {
      "date": "11.09.2013",
      "lotto": "3 8 25 32 34 45 20 22 (27)",
      "joker": "2 2 0 4 0",
      "prize": "316.866.390 kr.",
      "link": "http://lotto.is/lottoleikir/urslit/vikingalotto?_date=11.09.2013"
    },
    {
      "date": "04.09.2013",
      "lotto": "8 12 13 14 33 47 27 48 (3)",
      "joker": "9 5 8 0 1",
      "prize": "206.822.330 kr.",
      "link": "http://lotto.is/lottoleikir/urslit/vikingalotto?_date=04.09.2013"
    }
  ]
}
get /lottery/eurojackpot

Get the most recent numbers for EuroJackpot

No parameters available
jQuery demo
$.ajax({
  'url': 'http://apis.is/lottery/eurojackpot',
  'type': 'GET',
  'dataType': 'json',
  'success': function(response) {
    console.log(response);
  }
});
Response
{
  "results": [
    {
      "date": "13.09.2013",
      "lotto": "3 10 18 31 43 1 (7)",
      "joker": "1 8 3 1 3",
      "prize": "2.456.318.720 kr.",
      "link": "http://lotto.is/lottoleikir/urslit/eurojackpot?_date=13.09.2013"
    },
    {
      "date": "06.09.2013",
      "lotto": "3 7 20 32 44 4 (5)",
      "joker": "0 5 5 5 8",
      "prize": "2.137.751.150 kr.",
      "link": "http://lotto.is/lottoleikir/urslit/eurojackpot?_date=06.09.2013"
    }
  ]
}

Particulates in Reykjavik

Source: Reykjavik City

get /particulates

Get current status of particulates in Reykjavik City

No parameters available
jQuery demo
$.ajax({
  'url': 'http://apis.is/particulates',
  'type': 'GET',
  'dataType': 'json',
  'success': function(response) {
    console.log(response);
  }
});
Response
{
  "results": [
    {
      "PM10nuna": "0",
      "PM10medaltal": "9.1",
      "Counter": "29",
      "Dags": "2013-09-18",
      "nanariuppl": "http://www.rvk.is/desktopdefault.aspx/tabid-1007"
    }
  ]
}

Carpooling in Iceland

Source: samferda.net

get /rides/samferda-drivers/

Get a list of drivers requesting passengers, sorted by departure date.

No parameters available
jQuery demo
$.ajax({
  'url': 'http://apis.is/rides/samferda-drivers/',
  'type': 'GET',
  'dataType': 'json',
  'success': function(response) {
    console.log(response);
  }
});
Response
{
  "results": [
    {
      "link": "http://www.samferda.net/en/detail/12345",
      "from": "Akureyri",
      "to":   "Reykjavík",
      "date": "2014-09-30",
      "time": "After 14:30"
    }
  ]
}
get /rides/samferda-passengers/

Get a list of passengers requesting rides, sorted by preferred departure date

No parameters available
jQuery demo
$.ajax({
  'url': 'http://apis.is/rides/samferda-passengers/',
  'type': 'GET',
  'dataType': 'json',
  'success': function(response) {
    console.log(response);
  }
});
Response
{
  "results": [
    {
      "link": "http://www.samferda.net/en/detail/54321",
      "to":   "Reykjavík",
      "from": "Akureyri",
      "date": "2014-09-30",
      "time": "Any"
    }
  ]
}

Landsbjörg SAR School course schedule

Source: SAR School

get /sarschool

Get a list of all courses scheduled by the Search and Rescue school for training of SAR Squad members.

No parameters available
jQuery demo
$.ajax({
  'url': 'http://apis.is/sarschool',
  'type': 'GET',
  'dataType': 'json',
  'success': function(response) {
    console.log(response);
  }
});
Response
{
  "results": [
    {
      "id": 2753,
      "name": "Snjóflóð 2",
      "time_start": "2015-01-08",
      "time_end": "2015-01-11",
      "sar_members_only": 0,
      "host": "Squad",
      "location": "Siglufjörður",
      "price_regular": 54000,
      "price_members": 21600,
      "link": "http://skoli.landsbjorg.is/Open/Course.aspx?Id=2753"
    },
    {
      "id": 3017,
      "name": "Snjóflóð 1",
      "time_start": "2015-01-08",
      "time_end": "2015-01-11",
      "sar_members_only": 0,
      "host": "Squad",
      "location": "Siglufjörður",
      "price_regular": 42280,
      "price_members": 15100,
      "link": "http://skoli.landsbjorg.is/Open/Course.aspx?Id=3017"
    }
  ]
}

Sport events in Iceland

Sources: KSÍ and HSÍ

get /sports/:sport

Get events for icelandic football and/or handball

Parameters
/:sport
Which sport events to get (football|handball)
Response (no sport)
{
  "results": [
    {
      "info": "This is an api for Ielandic sports events",
      "endpoints": {
        "football": "/sports/football/",
        "handball": "/sports/handball/"
      }
    }
  ]
}
Response (/football)
{
  "results": [
    {
      "counter": "2",
      "date": "fös. 09. jan",
      "time": "19:15",
      "tournament": "Innimót - Úrslitakeppni mfl. karla",
      "location": "Fylkishöll",
      "homeTeam": "Fylkir",
      "awayTeam": "Stál-úlfur"
    },
    {
      "counter": "3",
      "date": "fös. 09. jan",
      "time": "19:30",
      "tournament": "Innimót - Úrslitakeppni mfl. karla",
      "location": "Álftanes",
      "homeTeam": "Víkingur Ó.",
      "awayTeam": "KFG"
    },
    {
      "counter": "4",
      "date": "fös. 09. jan",
      "time": "20:30",
      "tournament": "Innimót - Úrslitakeppni mfl. karla",
      "location": "Laugardalshöll",
      "homeTeam": "Fjölnir",
      "awayTeam": "Grundarfjörður"
    }
  ]
}
Response (/handball)
{
  "results": [
    {
      "Date": "�ri.  9.sep.2014",
      "Time": "18.00",
      "Tournament": "RVK m�t karla",
      "Venue": "�M Grafarvogi",
      "Teams": "Fj�lnir - KR"
    },
    {
      "Date": "�ri.  9.sep.2014",
      "Time": "19.30",
      "Tournament": "RVK m�t karla",
      "Venue": "Framh�s",
      "Teams": "Fram - V�kingur"
    },
    {
      "Date": "Mi�. 10.sep.2014",
      "Time": "19.30",
      "Tournament": "RVK m�t kvenna",
      "Venue": "Vodafone h�llin",
      "Teams": "Valur - Fram"
    }
  ]
}

Icelandic television schedules

Sources: RÚVStöð 2 and SkjárEinn

get /tv/:channel

Get schedules for icelandic tv stations.

Parameters
/:channel
Which channel's schedule to get
Response (no channel)
{
  "results": [
    {
      "info": "This is an api for Icelandic tv channel schedules",
      "endpoints": {
        "ruv": "/tv/ruv/",
        "ruvithrottir": "/tv/ruvithrottir/",
        "stod2": "/tv/stod2/",
        "stod2sport": "/tv/stod2sport",
        "stod2sport2": "/tv/stod2sport2",
        "stod2gull": "/tv/stod2gull",
        "stod2bio": "/tv/stod2bio",
        "stod3": "/tv/stod3",
        "skjar1": "/tv/skjar1"
      }
    }
  ]
}
Response (/ruv)
{
  "results": [
    {
      "title": "Sm\u00e6lki",
      "originalTitle": "Small Potatoes",
      "duration": "00:03:00",
      "description": "",
      "shortDescription": "",
      "live": false,
      "premier": true,
      "startTime": "2014-07-05 07:01:00",
      "aspectRatio": "16:9",
      "series": {
        "episode": "24",
        "series": "26"
      }
    }
  ]
}
Response (/ruvithrottir)
{
  "results": [
    {
      "title": "HM \u00ed f\u00f3tbolta",
      "originalTitle": "Holland - Argent\u00edna",
      "duration": "00:25:00",
      "description": "Upptaka fr\u00e1 leik \u00ed undan\u00farslitum HM \u00ed f\u00f3tbolta sem fram fer \u00ed Brasil\u00edu.",
      "shortDescription": "",
      "live": false,
      "premier": true,
      "startTime": "2014-07-09 22:45:00",
      "aspectRatio": "16:9",
      "series": {
        "episode": "1",
        "series": "1"
      }
    }
  ]
}
Response (/stod2)
{
  "results": [
    {
      "title": "Fr\u00e9ttir",
      "originalTitle": "",
      "duration": "0:45",
      "description": "Fr\u00e9ttir St\u00f6\u00f0var 2 endurs\u00fdndar fr\u00e1 \u00fev\u00ed fyrr \u00ed kv\u00f6ld.",
      "live": "false",
      "premier": "true",
      "startTime": "2014-07-06 05:25:00",
      "aspectRatio": "4\/3",
      "series": {
        "episode": "",
        "series": ""
      }
    }
  ]
}
Response (/stod2sport)
{
  "results": [
    {
      "title": "Arsenal -  Liverpool",
      "originalTitle": "FA bikarinn",
      "duration": "1:55",
      "description": "\u00datsending fr\u00e1 leik Arsenal og Liverpool \u00ed FA bikarnum.",
      "live": false,
      "premier": false,
      "startTime": "2014-07-09 18:20:00",
      "aspectRatio": "16\/9",
      "series": {
        "episode": "",
        "series": ""
      }
    }
  ]
}
Response (/stod2sport2)
{
  "results": [
    {
      "title": "Brasil\u00eda - \u00de\u00fdskaland",
      "originalTitle": "HM 2014",
      "duration": "1:40",
      "description": "\u00datsending fr\u00e1 leik Brasil\u00edu og \u00de\u00fdskalands \u00ed undan\u00farslitum \u00e1 HM 2014.",
      "live": false,
      "premier": false,
      "startTime": "2014-07-09 07:00:00",
      "aspectRatio": "16\/9",
      "series": {
        "episode": "",
        "series": ""
      }
    }
  ]
}
Response (/stod2gull)
{
  "results": [
    {
      "title": "Str\u00e1karnir",
      "originalTitle": "",
      "duration": "0:25",
      "description": "Sveppi, Auddi og P\u00e9tur halda uppteknum h\u00e6tti og sprella sem aldrei fyrr me\u00f0 \u00f3borganlegum upp\u00e1t\u00e6kjum.",
      "live": false,
      "premier": false,
      "startTime": "2014-07-09 17:55:00",
      "aspectRatio": "4\/3",
      "series": {
        "episode": "",
        "series": ""
      }
    }
  ]
}
Response (/stod2bio)
{
  "results": [
    {
      "title": "Argo",
      "originalTitle": "",
      "duration": "2:00",
      "description": "Fr\u00e1b\u00e6r mynd sem hlaut \u00d3skarsver\u00f0launin fyrr \u00e1 \u00feessu \u00e1ri sem besta myndin auk \u00feess sem h\u00fan hlaut ver\u00f0laun fyrir handriti\u00f0 og klippingu. Alls var myndin tilnefnd til sj\u00f6 \u00d3skarsver\u00f0launa. Myndin gerist \u00e1ri\u00f0 1980 \u00feegar bylting var ger\u00f0 \u00ed \u00cdran og starfsmenn bandar\u00edska sendir\u00e1\u00f0sins voru teknir \u00ed g\u00edslingu. L\u00edtill h\u00f3pur n\u00e1\u00f0i a\u00f0 l\u00e6\u00f0ast \u00fat og leita skj\u00f3ls \u00ed kanad\u00edska sendiherrab\u00fasta\u00f0num og bandar\u00edsk yfirv\u00f6ld \u00feurftu a\u00f0 beita frumlegum a\u00f0fer\u00f0um til a\u00f0 frelsa h\u00f3pinn. Leikstj\u00f3ri myndarinnar er Ben Affleck sem einnig leikur a\u00f0alhlutverki\u00f0.",
      "live": false,
      "premier": false,
      "startTime": "2014-07-09 03:15:00",
      "aspectRatio": "16\/9",
      "series": {
        "episode": "",
        "series": ""
      }
    }
  ]
}
Response (/stod3)
{
  "results": [
    {
      "title": "Malibu Country",
      "originalTitle": "",
      "duration": "0:25",
      "description": "Skemmtilegir gaman\u00fe\u00e6ttir um konu \u00e1 besta aldri \u00ed Nashville sem skilur vi\u00f0 eiginmann sinn og flyst me\u00f0 fj\u00f6lskyldu s\u00edna til Malibu. \u00dear reynir \u00e1 a\u00f0l\u00f6gunarh\u00e6fni \u00feeirra allra en h\u00fan reynir fyrir s\u00e9r sem s\u00f6ngkona og b\u00f6rnin reyna a\u00f0 tapa s\u00e9r ekki \u00ed efnishyggjunni sem vir\u00f0ist yfirr\u00e1\u00f0andi.",
      "live": false,
      "premier": false,
      "startTime": "2014-07-09 18:10:00",
      "aspectRatio": "16\/9",
      "series": {
        "episode": "14",
        "series": "18"
      }
    }
  ]
}
Response (/skjar1)
{
  "results": [
    {
      "title": "Leverage",
      "originalTitle": "Leverage 5",
      "duration": "00:46:00",
      "description": "\u00deetta er fimmta \u00fe\u00e1ttar\u00f6\u00f0in af Leverage, \u00e6sispennandi \u00fe\u00e1ttar\u00f6\u00f0 \u00ed anda Ocean\u2019s Eleven um \u00fej\u00f3fah\u00f3p sem r\u00e6nir \u00fe\u00e1 sem misnota vald sitt og r\u00edkid\u00e6mi og n\u00ed\u00f0ast \u00e1 minnim\u00e1ttar.",
      "shortDescription": "Nate ver\u00f0ur a\u00f0 hreinsa mannor\u00f0 Sophie \u00feegar h\u00fan er grunu\u00f0 um \u00fej\u00f3fna\u00f0 \u00e1 \u00f3metanlegu m\u00e1lverki.",
      "live": false,
      "premier": true,
      "startTime": "2014-07-09 23:54",
      "aspectRatio": "",
      "series": {
        "episode": "10",
        "series": "15"
      }
    }
  ]
}

Icelandic Weather

Source: Icelandic Meteorological Office

get /weather/:source/:lang

Get weather information for Iceland.
Under 'Descriptions' you will find a list that will help you understand the output of the following endpoints.

Parameters
/:type
Type of information to get (forecasts|observations|texts)
/:lang
Language of output ('en' or 'is'), defaults to 'is'
Descriptions
var descriptions = {
  'F'   : { 'is': 'Vindhraði (m/s)',
            'en': 'Wind speed (m/s)'},
  'FX'  : { 'is': 'Mesti vindhraði (m/s)',
            'en': 'Top wind speed (m/s)'},
  'FG'  : { 'is': 'Mesta vindhviða (m/s)',
            'en': 'Top wind gust (m/s)'},
  'D'   : { 'is': 'Vindstefna',
            'en': 'Wind direction'},
  'T'   : { 'is': 'Hiti (°C)',
            'en': 'Air temperature (°C)'},
  'W'   : { 'is': 'Veðurlýsing',
            'en': 'Weather description'},
  'V'   : { 'is': 'Skyggni (km)',
            'en': 'Visibility (km)'},
  'N'   : { 'is': 'Skýjahula (%)',
            'en': 'Cloud cover (%)'},
  'P'   : { 'is': 'Loftþrýstingur (hPa)',
            'en': 'Air pressure'},
  'RH'  : { 'is': 'Rakastig (%)',
            'en': 'Humidity (%)'},
  'SNC' : { 'is': 'Lýsing á snjó',
            'en': 'Snow description'},
  'SND' : { 'is': 'Snjódýpt',
            'en': 'Snow depth'},
  'SED' : { 'is': 'Snjólag',
            'en': 'Snow type'},
  'RTE' : { 'is': 'Vegahiti (°C)',
            'en': 'Road temperature (°C)'},
  'TD'  : { 'is': 'Daggarmark (°C)',
            'en': 'Dew limit (°C)'},
  'R'   : { 'is': 'Uppsöfnuð úrkoma (mm/klst) úr sjálfvirkum mælum',
            'en': 'Cumulative precipitation (mm/h) from automatic measuring units'}
};
get /weather/forecasts/:lang
Parameters
/:lang
Language of output ('en' or 'is'), defaults to 'is'
stations
List of station numbers seperated by commas(,) or semicolons(;).
See links below for more information.
Weather stations (icelandic) | Weather stations (english)
jQuery demo
$.ajax({
  'url': 'http://apis.is/weather/forecasts/en',
  'type': 'GET',
  'dataType': 'json',
  'data': {'stations': '1,422'},
  'success': function(response) {
    console.log(response);
  }
});
Response
{
  "results": [
    {
      "name": "Reykjavík",
      "atime": "2013-09-17 12:00:00",
      "err": "",
      "link": "http://en.vedur.is/WeatherServlet/weather/forecasts/areas/reykjavik/#group=100&station=1",
      "forecast": [
        {
          "ftime": "2013-09-17 15:00:00",
          "F": "9",
          "D": "N",
          "T": "7",
          "W": "Clear sky",
          "N": "0",
          "TD": "-3",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-17 18:00:00",
          "F": "8",
          "D": "N",
          "T": "7",
          "W": "Clear sky",
          "N": "0",
          "TD": "-4",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-17 21:00:00",
          "F": "8",
          "D": "N",
          "T": "6",
          "W": "Partly cloudy",
          "N": "20",
          "TD": "-4",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-18 00:00:00",
          "F": "6",
          "D": "NNW",
          "T": "5",
          "W": "Partly cloudy",
          "N": "40",
          "TD": "-3",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-18 03:00:00",
          "F": "6",
          "D": "N",
          "T": "5",
          "W": "Cloudy",
          "N": "70",
          "TD": "-4",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-18 06:00:00",
          "F": "5",
          "D": "NNW",
          "T": "4",
          "W": "Partly cloudy",
          "N": "30",
          "TD": "-2",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-18 09:00:00",
          "F": "5",
          "D": "N",
          "T": "5",
          "W": "Clear sky",
          "N": "0",
          "TD": "-2",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-18 12:00:00",
          "F": "4",
          "D": "NNW",
          "T": "6",
          "W": "Clear sky",
          "N": "0",
          "TD": "-3",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-18 15:00:00",
          "F": "3",
          "D": "NNW",
          "T": "7",
          "W": "Clear sky",
          "N": "0",
          "TD": "-3",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-18 18:00:00",
          "F": "3",
          "D": "N",
          "T": "8",
          "W": "Partly cloudy",
          "N": "0",
          "TD": "-2",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-18 21:00:00",
          "F": "3",
          "D": "NE",
          "T": "6",
          "W": "Cloudy",
          "N": "100",
          "TD": "0",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-19 00:00:00",
          "F": "2",
          "D": "E",
          "T": "4",
          "W": "Overcast",
          "N": "90",
          "TD": "0",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-19 03:00:00",
          "F": "3",
          "D": "ESE",
          "T": "4",
          "W": "Light rain",
          "N": "100",
          "TD": "1",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-19 06:00:00",
          "F": "4",
          "D": "ESE",
          "T": "5",
          "W": "Light rain",
          "N": "100",
          "TD": "3",
          "R": "0.4"
        },
        {
          "ftime": "2013-09-19 09:00:00",
          "F": "4",
          "D": "ESE",
          "T": "5",
          "W": "Light rain",
          "N": "100",
          "TD": "4",
          "R": "0.4"
        },
        {
          "ftime": "2013-09-19 12:00:00",
          "F": "5",
          "D": "SE",
          "T": "7",
          "W": "Light rain",
          "N": "100",
          "TD": "5",
          "R": "0.8"
        },
        {
          "ftime": "2013-09-19 15:00:00",
          "F": "7",
          "D": "ESE",
          "T": "7",
          "W": "Light rain",
          "N": "100",
          "TD": "5",
          "R": "0.6"
        },
        {
          "ftime": "2013-09-19 18:00:00",
          "F": "7",
          "D": "ESE",
          "T": "5",
          "W": "Light rain",
          "N": "100",
          "TD": "4",
          "R": "1.7"
        },
        {
          "ftime": "2013-09-20 00:00:00",
          "F": "7",
          "D": "ESE",
          "T": "5",
          "W": "Rain",
          "N": "100",
          "TD": "4",
          "R": "2.2"
        },
        {
          "ftime": "2013-09-20 06:00:00",
          "F": "2",
          "D": "SE",
          "T": "3",
          "W": "Rain",
          "N": "100",
          "TD": "3",
          "R": "8.1"
        },
        {
          "ftime": "2013-09-20 12:00:00",
          "F": "2",
          "D": "NW",
          "T": "6",
          "W": "Rain showers",
          "N": "30",
          "TD": "2",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-20 18:00:00",
          "F": "5",
          "D": "W",
          "T": "6",
          "W": "Rain",
          "N": "100",
          "TD": "3",
          "R": "1.3"
        },
        {
          "ftime": "2013-09-21 00:00:00",
          "F": "3",
          "D": "WSW",
          "T": "5",
          "W": "Rain",
          "N": "100",
          "TD": "5",
          "R": "8.7"
        },
        {
          "ftime": "2013-09-21 06:00:00",
          "F": "3",
          "D": "WSW",
          "T": "6",
          "W": "Light rain",
          "N": "80",
          "TD": "5",
          "R": "1.0"
        },
        {
          "ftime": "2013-09-21 12:00:00",
          "F": "3",
          "D": "WSW",
          "T": "7",
          "W": "Light rain",
          "N": "90",
          "TD": "5",
          "R": "0.5"
        },
        {
          "ftime": "2013-09-21 18:00:00",
          "F": "2",
          "D": "W",
          "T": "8",
          "W": "Rain showers",
          "N": "60",
          "TD": "5",
          "R": "0.8"
        },
        {
          "ftime": "2013-09-22 00:00:00",
          "F": "3",
          "D": "E",
          "T": "4",
          "W": "Overcast",
          "N": "100",
          "TD": "3",
          "R": "0.1"
        },
        {
          "ftime": "2013-09-22 06:00:00",
          "F": "4",
          "D": "ENE",
          "T": "6",
          "W": "Overcast",
          "N": "100",
          "TD": "2",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-22 12:00:00",
          "F": "6",
          "D": "E",
          "T": "8",
          "W": "Rain",
          "N": "100",
          "TD": "2",
          "R": "0.3"
        },
        {
          "ftime": "2013-09-22 18:00:00",
          "F": "7",
          "D": "ESE",
          "T": "8",
          "W": "Rain",
          "N": "100",
          "TD": "7",
          "R": "5.2"
        },
        {
          "ftime": "2013-09-23 00:00:00",
          "F": "8",
          "D": "SSE",
          "T": "9",
          "W": "Light rain",
          "N": "100",
          "TD": "9",
          "R": "1.1"
        }
      ],
      "id": "1",
      "valid": "1"
    },
    {
      "name": "Akureyri",
      "atime": "2013-09-17 12:00:00",
      "err": "",
      "link": "http://en.vedur.is/WeatherServlet/weather/forecasts/areas/northeast/#group=15&station=422",
      "forecast": [
        {
          "ftime": "2013-09-17 15:00:00",
          "F": "5",
          "D": "NNW",
          "T": "2",
          "W": "Light rain",
          "N": "100",
          "TD": "0",
          "R": "0.4"
        },
        {
          "ftime": "2013-09-17 18:00:00",
          "F": "5",
          "D": "NNW",
          "T": "2",
          "W": "Light rain",
          "N": "100",
          "TD": "0",
          "R": "0.5"
        },
        {
          "ftime": "2013-09-17 21:00:00",
          "F": "4",
          "D": "NW",
          "T": "1",
          "W": "Sleet",
          "N": "100",
          "TD": "0",
          "R": "1.1"
        },
        {
          "ftime": "2013-09-18 00:00:00",
          "F": "3",
          "D": "NW",
          "T": "1",
          "W": "Sleet",
          "N": "100",
          "TD": "-1",
          "R": "1.5"
        },
        {
          "ftime": "2013-09-18 03:00:00",
          "F": "2",
          "D": "NW",
          "T": "1",
          "W": "Sleet",
          "N": "100",
          "TD": "-1",
          "R": "1.7"
        },
        {
          "ftime": "2013-09-18 06:00:00",
          "F": "2",
          "D": "NW",
          "T": "2",
          "W": "Light sleet",
          "N": "100",
          "TD": "-1",
          "R": "0.9"
        },
        {
          "ftime": "2013-09-18 09:00:00",
          "F": "2",
          "D": "NW",
          "T": "2",
          "W": "Light rain",
          "N": "80",
          "TD": "-1",
          "R": "0.6"
        },
        {
          "ftime": "2013-09-18 12:00:00",
          "F": "1",
          "D": "NNW",
          "T": "3",
          "W": "Light rain",
          "N": "90",
          "TD": "0",
          "R": "0.3"
        },
        {
          "ftime": "2013-09-18 15:00:00",
          "F": "2",
          "D": "NNE",
          "T": "4",
          "W": "Light rain",
          "N": "100",
          "TD": "1",
          "R": "0.2"
        },
        {
          "ftime": "2013-09-18 18:00:00",
          "F": "2",
          "D": "NNE",
          "T": "2",
          "W": "Cloudy",
          "N": "80",
          "TD": "1",
          "R": "0.2"
        },
        {
          "ftime": "2013-09-18 21:00:00",
          "F": "1",
          "D": "NE",
          "T": "1",
          "W": "Cloudy",
          "N": "50",
          "TD": "0",
          "R": "0.1"
        },
        {
          "ftime": "2013-09-19 00:00:00",
          "F": "1",
          "D": "NNE",
          "T": "1",
          "W": "Cloudy",
          "N": "60",
          "TD": "0",
          "R": "0.1"
        },
        {
          "ftime": "2013-09-19 03:00:00",
          "F": "0",
          "D": "Calm",
          "T": "1",
          "W": "Cloudy",
          "N": "50",
          "TD": "-1",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-19 06:00:00",
          "F": "1",
          "D": "ESE",
          "T": "1",
          "W": "Cloudy",
          "N": "80",
          "TD": "-1",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-19 09:00:00",
          "F": "2",
          "D": "SE",
          "T": "2",
          "W": "Overcast",
          "N": "90",
          "TD": "0",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-19 12:00:00",
          "F": "2",
          "D": "SE",
          "T": "6",
          "W": "Overcast",
          "N": "100",
          "TD": "3",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-19 15:00:00",
          "F": "2",
          "D": "ESE",
          "T": "8",
          "W": "Overcast",
          "N": "90",
          "TD": "3",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-19 18:00:00",
          "F": "1",
          "D": "SE",
          "T": "1",
          "W": "Overcast",
          "N": "100",
          "TD": "-1",
          "R": "0.1"
        },
        {
          "ftime": "2013-09-20 00:00:00",
          "F": "1",
          "D": "ESE",
          "T": "1",
          "W": "Light sleet",
          "N": "100",
          "TD": "-1",
          "R": "0.5"
        },
        {
          "ftime": "2013-09-20 06:00:00",
          "F": "1",
          "D": "E",
          "T": "1",
          "W": "Light sleet",
          "N": "100",
          "TD": "0",
          "R": "0.4"
        },
        {
          "ftime": "2013-09-20 12:00:00",
          "F": "1",
          "D": "SSE",
          "T": "1",
          "W": "Light sleet",
          "N": "100",
          "TD": "0",
          "R": "1.2"
        },
        {
          "ftime": "2013-09-20 18:00:00",
          "F": "1",
          "D": "SW",
          "T": "2",
          "W": "Cloudy",
          "N": "30",
          "TD": "0",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-21 00:00:00",
          "F": "2",
          "D": "SW",
          "T": "-1",
          "W": "Cloudy",
          "N": "90",
          "TD": "-3",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-21 06:00:00",
          "F": "2",
          "D": "SSW",
          "T": "0",
          "W": "Overcast",
          "N": "100",
          "TD": "-2",
          "R": "0.3"
        },
        {
          "ftime": "2013-09-21 12:00:00",
          "F": "2",
          "D": "SW",
          "T": "3",
          "W": "Overcast",
          "N": "100",
          "TD": "0",
          "R": "0.1"
        },
        {
          "ftime": "2013-09-21 18:00:00",
          "F": "1",
          "D": "SSW",
          "T": "3",
          "W": "Cloudy",
          "N": "60",
          "TD": "1",
          "R": "0.1"
        },
        {
          "ftime": "2013-09-22 00:00:00",
          "F": "1",
          "D": "SSW",
          "T": "-1",
          "W": "Cloudy",
          "N": "70",
          "TD": "-1",
          "R": "0.1"
        },
        {
          "ftime": "2013-09-22 06:00:00",
          "F": "1",
          "D": "SSE",
          "T": "-3",
          "W": "Overcast",
          "N": "90",
          "TD": "-3",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-22 12:00:00",
          "F": "1",
          "D": "ESE",
          "T": "0",
          "W": "Light snow",
          "N": "100",
          "TD": "-1",
          "R": "0.0"
        },
        {
          "ftime": "2013-09-22 18:00:00",
          "F": "1",
          "D": "ESE",
          "T": "1",
          "W": "Light sleet",
          "N": "100",
          "TD": "0",
          "R": "1.2"
        },
        {
          "ftime": "2013-09-23 00:00:00",
          "F": "1",
          "D": "SSE",
          "T": "3",
          "W": "Light rain",
          "N": "100",
          "TD": "1",
          "R": "1.4"
        }
      ],
      "id": "422",
      "valid": "1"
    }
  ]
}
get /weather/observations/:lang
Parameters
/:lang
Language of output ('en' or 'is'), defaults to 'is'
stations
List of station numbers seperated by commas(,) or semicolons(;).
See links below for more information.
Weather stations (icelandic) | Weather stations (english)
time
1h (default) = Fetch data from automatic weather stations that are updated on the hour.
3h = Only fetch mixed data from manned and automatic weather stations that is updated every 3 hours.
anytime
0 (default) = an error will be returned if current data is not available.
1 = last available numbers will be displayed, regardless of date.
jQuery demo
$.ajax({
  'url': 'http://apis.is/weather/observations/en',
  'type': 'GET',
  'dataType': 'json',
  'data': {'stations': '1,422', 'time': '1h', 'anytime': '0'},
  'success': function(response) {
    console.log(response);
  }
});
Response
{
  "results": [
    {
      "name": "Reykjavík",
      "time": "2013-09-17 16:00:00",
      "err": "",
      "link": "http://en.vedur.is/WeatherServlet/weather/observations/areas/reykjavik/#group=100&station=1",
      "F": "8",
      "FX": "9",
      "FG": "16",
      "D": "NNE",
      "T": "5.6",
      "W": "",
      "V": "",
      "N": "",
      "P": "1003",
      "RH": "58",
      "SNC": "",
      "SND": "",
      "SED": "",
      "RTE": "",
      "TD": "-2.0",
      "R": "0.1",
      "id": "1",
      "valid": "1"
    },
    {
      "name": "Akureyri",
      "time": "2013-09-17 16:00:00",
      "err": "",
      "link": "http://en.vedur.is/WeatherServlet/weather/observations/areas/northeast/#group=15&station=422",
      "F": "10",
      "FX": "11",
      "FG": "15",
      "D": "NNW",
      "T": "3.3",
      "W": "",
      "V": "",
      "N": "",
      "P": "1001",
      "RH": "79",
      "SNC": "",
      "SND": "",
      "SED": "",
      "RTE": "",
      "TD": "0.0",
      "R": "0.0",
      "id": "422",
      "valid": "1"
    }
  ]
}
get /weather/texts
Parameters
types
List of types seperated by commas(,) or semicolons(;).
See 'Valid types' below for full list of valid type numbers and what they stand for.
Valid types
"2" = "Veðurhorfur á landinu"
"3" = "Veðurhorfur á höfuðborgarsvæðinu"
"5" = "Veðurhorfur á landinu næstu daga"
"6" = "Veðurhorfur á landinu næstu daga"
"7" = "Weather outlook"
"9" = "Veðuryfirlit"
"10" = "Veðurlýsing"
"11" = "Íslenskar viðvaranir fyrir land"
"12" = "Veðurhorfur á landinu"
"14" = "Enskar viðvaranir fyrir land"
"27" = "Weather forecast for the next several days"
"30" = "Miðhálendið"
"31" = "Suðurland"
"32" = "Faxaflói"
"33" = "Breiðafjörður"
"34" = "Vestfirðir"
"35" = "Strandir og Norðurland vestra"
"36" = "Norðurlandi eystra"
"37" = "Austurland að Glettingi"
"38" = "Austfirðir"
"39" = "Suðausturland"
"42" = "General synopsis
jQuery demo
$.ajax({
  'url': 'http://apis.is/weather/texts',
  'type': 'GET',
  'dataType': 'json',
  'data': {'types': '5,6'},
  'success': function(response) {
    console.log(response);
  }
});
Response
{
  "results": [
    {
      "title": "Veðurhorfur á landinu næstu daga",
      "creation": "2013-09-17 09:16:29",
      "valid_from": "2013-09-19 12:00:00",
      "valid_to": "2013-09-24 12:00:00",
      "content": "Á fimmtudag: Suðaustan 8-13 m/s S- og V-lands og rigning með köflum, en hægari og bjartviðri á NA- og A-landi. Hiti 2 til 10 stig, kaldast í innsveitum NA-lands. Á föstudag: Suðaustlæg eða breytileg átt, 3-10 m/s. Rigning eða skúrir í flestum landshlutum. Hiti 3 til 8 stig. Á laugardag: Vestan- og norðvestanátt, víða 3-8 m/s. Skýjað að mestu en úrkomulítið um V- og N-vert landið, en bjartviðri annars staðar. Hiti 3 til 10 stig, hlýjast á SA-landi. Á sunnudag: Útlit fyrir vaxandi suðaustanátt með rigningu, einkum S-til á landinu. Hlýnar í veðri. Á mánudag: Horfur á suðvestanátt með rigningu eða skúrum, en þurrt og bjart eystra.",
      "id": "5"
    },
    {
      "title": "Veðurhorfur á landinu næstu daga",
      "creation": "2013-09-17 09:19:17",
      "valid_from": "2013-09-19 12:00:00",
      "valid_to": "2013-09-24 12:00:00",
      "content": "Suðaustan 8-13 m/s á fimmtudag S- og V-lands og rigning með köflum, en hægari og þurrt annars staðar. Breytileg átt 5-10 á föstudag og víða væta, en 3-8 á laugardag og úrkomulítið. Horfur á vaxandi suðaustanátt á sunnudag með rigningu og hlýnandi veðri.",
      "id": "6"
    }
  ]
}