API Refence

List of requests.

List the latest image albums in the database

List the most recent image albums (events) in the database.

Request

GET https://api.bildbyran.se/v1/albums

Request parameters

Parameter Example Description
limit 1000 Maximum search results
offset 1000 Start with result 1001 (useful for paging)

Response

Example JSON response

{
  "albums": [
    {
      "cover": "190303ZM026",
      "id": "190303_heere",
      "name": "Fotboll, Holländska Ligan,  Heerenveen - Willem II"
    },
    {
      "cover": "190303ZO022",
      "id": "190303_wolf",
      "name": "Fotboll, Bundesliga, Wolfsburg - Werder Bremen"
    },
    {
      "cover": "190303ZU011",
      "id": "190303_lyon",
      "name": "Fotboll, Franska Ligan, Lyon - Toulouse"
    },
    {
      "cover": "190303ZA020",
      "id": "190303_betis",
      "name": "Fotboll, La Liga, Betis - Getafe"
    },
    {
      "cover": "190303ZW011",
      "id": "190303_guin",
      "name": "Fotboll, Franska Ligan, Guingamp - Nantes"
    }
  ]
}



Attribute Description
cover Unique identifier for the album cover photo.
id Unique identifier for this album.
name Album title.

List the most recent images in the database

List the most recent images added to the database.

Request

GET https://api.bildbyran.se/v1/photos

Request parameters

Parameter Example Description
limit 1000 Maximum search results
offset 1000 Start with result 1001 (useful for paging)

Response

Example JSON response

{
  "photos": [
    {
      "id": "190303ZZ017",
      "caption": "190303 Fotboll, Franska Ligan, Lille - Dijon: Rui Da Rocha Fonte, Thiago Mendes, Thiago Maia Alencar and Gabriel Dos Santos Magalhaes of Lille celebrate victory with their fans during the Ligue 1 match between LOSC Lille and Dijon FCO on March 3, 2019 in Lille, France. (Photo by Aude Alcover/Icon Sport)r© Bildbyrån - COP 75 - SWEDEN AND NORWAY ONLY",
      "photographer": "Aude Alcover / BILDBYRÅN",
      "created": "2019-03-03T20:19:00+01:00"
    },
    {
      "id": "190303ZS022",
      "caption": "190303 Fotboll, Franska Ligan, Lille - Dijon: Jonathan Ikone, Jose Da Rocha Fonte, Xeka and Reinildo Mandava of Lille celebrate victory with their fans during the Ligue 1 match between LOSC Lille and Dijon FCO on March 3, 2019 in Lille, France. (Photo by Aude Alcover/Icon Sport)r© Bildbyrån - COP 75 - SWEDEN AND NORWAY ONLY",
      "photographer": "Aude Alcover / BILDBYRÅN",
      "created": "2019-03-03T20:19:00+01:00"
    },
    {
      "id": "190303ZE024",
      "caption": "190303 Fotboll, Bundesliga, Wolfsburg - Werder Bremen: 1:0 Tor, Jubel v.l. Torschuetze John Anthony Brooks, Josuha Guilavogui (Wolfsburg)rWolfsburg, 03.03.2019, Fussball Bundesliga, VfL Wolfsburg - SV Werder Bremenr© Bildbyrån - COP 39  - SWEDEN AND NORWAY ONLY",
      "photographer": "Timgroothuis / BILDBYRÅN",
      "created": "2019-03-03T20:15:41+01:00"
    },
    {
      "id": "190303ZO022",
      "caption": "190303 Fotboll, Bundesliga, Wolfsburg - Werder Bremen: 1:0 Tor, Jubel v.l. Josuha Guilavogui, Wout Weghorst, Torschuetze John Anthony Brooks (Wolfsburg)rWolfsburg, 03.03.2019, Fussball Bundesliga, VfL Wolfsburg - SV Werder Bremenr© Bildbyrån - COP 39  - SWEDEN AND NORWAY ONLY",
      "photographer": "Timgroothuis / BILDBYRÅN",
      "created": "2019-03-03T20:15:40+01:00"
    },
    {
      "id": "190303ZO021",
      "caption": "190303 Fotboll, Bundesliga, Wolfsburg - Werder Bremen: 1:0 Tor, Jubel v.l. Wout Weghorst, Torschuetze John Anthony Brooks (Wolfsburg)rWolfsburg, 03.03.2019, Fussball Bundesliga, VfL Wolfsburg - SV Werder Bremenr© Bildbyrån - COP 39  - SWEDEN AND NORWAY ONLY",
      "photographer": "Timgroothuis / BILDBYRÅN",
      "created": "2019-03-03T20:15:39+01:00"
    }
  ]
}



Attribute Description
id Unique identifier for the photo.
caption Unique identifier for this album.
photographer Photographer name
created Date photograph was taken in ISO 8601 format

Searching for photos

Search for phots containing a given string in our image archive.

Request

GET https://api.bildbyran.se/v1/photos?q=searchstring

Request parameters

Parameter Example Description
q Zlatan Ibrahimovic The string to search for
fromdate YYYYMMDD Limit the search results to photos newer then the specified date
todate YYYYMMDD Limit the search results to photos older then the specified date
limit 1000 Maximum search results
offset 1000 Start with result 1001 (useful for paging)

Response

Example JSON response

{
  "photos": [
    {
      "id": "181221JM006",
      "caption": "181221 This picture is part of Bildbyrån’s selection of the 100 best sports photos from 2018. Originally published 20180329. Zlatan Ibrahimovic, player of LA Galaxy, greets supporters when arriving at Los Angeles International Airport (LAX) on March 29, 2018 in Los Angeles. rPhoto: Joel Marklund / BILDBYRÅN / kod JM / 87666",
      "photographer": "Joel Marklund / BILDBYRÅN",
      "created": "2018-03-29T15:56:19+02:00"
    },
    {
      "id": "181112AE092",
      "caption": "181112 Grunden bois tilldelas Nr.10 stipendiet av Zlatan Ibrahimovic under Fotbollsgalan den 12 november 2018 i Stockholm. rFoto: Andreas L Eriksson / Bildbyrån / kod AE / Cop 106",
      "photographer": "Andreas L Eriksson / BILDBYRÅN",
      "created": "2018-11-12T21:43:20+01:00"
    },
    {
      "id": "181112AE091",
      "caption": "181112 Grunden bois tilldelas Nr.10 stipendiet av Zlatan Ibrahimovic under Fotbollsgalan den 12 november 2018 i Stockholm. rFoto: Andreas L Eriksson / Bildbyrån / kod AE / Cop 106",
      "photographer": "Andreas L Eriksson / BILDBYRÅN",
      "created": "2018-11-12T21:42:42+01:00"
    },
    {
      "id": "181112AE093",
      "caption": "181112 Grunden bois tilldelas Nr.10 stipendiet av Zlatan Ibrahimovic under Fotbollsgalan den 12 november 2018 i Stockholm. rFoto: Andreas L Eriksson / Bildbyrån / kod AE / Cop 106",
      "photographer": "Andreas L Eriksson / BILDBYRÅN",
      "created": "2018-11-12T21:42:27+01:00"
    },
    {
      "id": "181112AE089",
      "caption": "181112 Grunden Bois tilldelas Nr.10 stipendiet av Zlatan Ibrahimovic under Fotbollsgalan den 12 november 2018 i Stockholm. nFoto: Andreas L Eriksson / Bildbyrån / kod AE / Cop 106",
      "photographer": "Andreas L Eriksson / BILDBYRÅN",
      "created": "2018-11-12T21:41:10+01:00"
    }
  ],
  "size": 19055
}



Attribute Description
id Unique identifier for this Photo.
caption Caption data for this photo.
photographer Photographer for this photo.
created Date photograph was taken in ISO 8601 format
size Number of search results for the given string.
Maximum 10.000

Browse an image album

Browse images in a certain album (event) in the database.

Request

GET https://api.bildbyran.se/v1/photos?albumid=1234

Request parameters

Parameter Example Description
albumid AI180926_48a Unique identifier for the requested album
limit 1000 Maximum search results
offset 1000 Start with result 1001 (useful for paging)

Response

Example JSON response

{
  "photos": [
    {
      "id": "190303ZA018",
      "caption": "190303 Fotboll, Franska Ligan, Guingamp - Nantes: Andrei Girotto of Nantes and Lucas Deaux of Guingamp during the Ligue 1 match between EA Guingamp and FC Nantes on March 3, 2019 in Guingamp, France. (Photo by Vincent Michel/Icon Sport)r© Bildbyrån - COP 75 - SWEDEN AND NORWAY ONLY",
      "photographer": "Vincent Michel / BILDBYRÅN",
      "created": "2019-03-03T16:28:32+01:00"
    },
    {
      "id": "190303ZV012",
      "caption": "190303 Fotboll, Franska Ligan, Guingamp - Nantes: Ludovic Blas of Guingamp and Edgar Ie of Nantes during the Ligue 1 match between EA Guingamp and FC Nantes on March 3, 2019 in Guingamp, France. (Photo by Vincent Michel/Icon Sport)r© Bildbyrån - COP 75 - SWEDEN AND NORWAY ONLY",
      "photographer": "Vincent Michel / BILDBYRÅN",
      "created": "2019-03-03T16:28:20+01:00"
    },
    {
      "id": "190303ZE017",
      "caption": "190303 Fotboll, Franska Ligan, Guingamp - Nantes: Nicolas Benezet of Guingamp and Edgar Ie of Nantes during the Ligue 1 match between EA Guingamp and FC Nantes on March 3, 2019 in Guingamp, France. (Photo by Vincent Michel/Icon Sport)r© Bildbyrån - COP 75 - SWEDEN AND NORWAY ONLY",
      "photographer": "Vincent Michel / BILDBYRÅN",
      "created": "2019-03-03T16:28:16+01:00"
    },
    {
      "id": "190303ZH014",
      "caption": "190303 Fotboll, Franska Ligan, Guingamp - Nantes: Nicolas Benezet of Guingamp and Edgar Ie of Nantes during the Ligue 1 match between EA Guingamp and FC Nantes on March 3, 2019 in Guingamp, France. (Photo by Vincent Michel/Icon Sport)r© Bildbyrån - COP 75 - SWEDEN AND NORWAY ONLY",
      "photographer": "Vincent Michel / BILDBYRÅN",
      "created": "2019-03-03T16:28:16+01:00"
    },
    {
      "id": "190303ZP011",
      "caption": "190303 Fotboll, Franska Ligan, Guingamp - Nantes: Rene Krhin of Nantes during the Ligue 1 match between EA Guingamp and FC Nantes on March 3, 2019 in Guingamp, France. (Photo by Vincent Michel/Icon Sport)r© Bildbyrån - COP 75 - SWEDEN AND NORWAY ONLY",
      "photographer": "Vincent Michel / BILDBYRÅN",
      "created": "2019-03-03T16:22:08+01:00"
    }
  ],
  "size": 16
}



Attribute Description
id Unique identifier for this photo.
caption Photo caption.
photographer Photographer name.
created Date photograph was taken in ISO 8601 format
size Count of total number of photos in the album.

Retreive an image thumbnail

Retreiver the thumbnail of an image width a certain photo id.

Request

GET https://api.bildbyran.se/v1/photos/180916BB034/thumbnail?size=537x358||1920x1280

Request parameters

Parameter Example Description
size 1920x1280 Requested size of image in pixles.
3 options is valid: 1920x1280 or 537x358

Download an image

Retreive a full size image from the database

Request

GET https://api.bildbyran.se/v1/photos/180916BB034/download?size=1920x1280||max

Request parameters

Parameter Example Description
size 1920x1280 Requested size of image in pixles.
2 options is valid: 1920x1280 or max

Retreive metadata

Retreive metadata for a certain image using the unique photo id.

Request

GET https://api.bildbyran.se/v1/photos/170511JM001

Response

Example JSON response

{
  "id": "170511JM001",
  "width": 5288,
  "height": 3525,
  "orientation": 1,
  "filesize": 2998073,
  "created": "2017-05-11T19:36:51+02:00",
  "city": "Köln",
  "country": "Tyskland",
  "objectname": "Ishockey, ishockey-VM 2017, dag 7, Sverige - Lettland",
  "category": "SPO",
  "albumid": "87446",
  "caption": "170511 Sveriges Marcus Krüger, Elias Lindholm, Carl Söderberg, Carl Klingberg, Joakim Nordström och Linus Omark värmer upp inför ishockeymatchen mellan Sverige och Lettland på ishockey-VM den 11 maj 2017 i Köln.rFoto: Joel Marklund / BILDBYRÅN / kod JM / 87446",
  "photographer": "Joel Marklund",
  "keywords": "ishockey;ice hockey;iihf world championship;vm;ishockey-vm;sverige;sweden;lettland;latvia;uppvärmning;genre"
}



Attribute Description
id Unique identifier for this photo.
width Width of photo in pixels
height Height of photo in pixels
orientation Orientation for the photo (1=horizontal, 2=square, 3=vertical)
filesize Height of photo in bytes
created Date when photo was taken in ISO 8601 format
city Name of city where photo was taken
country Name of country where photo was taken
objectname Name of album (event) contatining image
category SPO (sport related images) or ALL (general archive)
albumid ID of album (event) contatining image
caption Caption for photo
photographer Name of photographer
keywords Search keywords for photo

Most popular images

List the most popular images in the database for a given set of days.

Request

GET https://api.bildbyran.se/v1/photos?sorting=popularity

Request parameters

Parameter Example Description
days 1-7 Number of days to look for (max 7)
limit 1000 Maximum search results
offset 1000 Start with result 1001 (useful for paging)

Response

Example JSON response

{
  "photos": [
    {
      "id": "190225DS016",
      "caption": "190225 GAIS målvakt Marko Johansson tar sig för örat när han lämnar planen efter IFK Göteborgs supportrar bränt pyroteknik under fotbollsmatchen i Svenska Cupen mellan IFK Göteborg och Gais den 25 februari 2019 i Göteborg. rFoto: Daniel Stiller / Bildbyrån / kod DS / 59319",
      "photographer": "Daniel Stiller / BILDBYRÅN",
      "created": "2019-02-25T20:04:49+01:00"
    },
    {
      "id": "190226JM104",
      "caption": "190226 Frida Karlsson of Sweden celebrates after women's 10 km classic during the FIS Nordic World Ski Championships on February 26, 2019 in Seefeld in Tirol.rPhoto: Joel Marklund / BILDBYRÅN / kod JM / 87897",
      "photographer": "Joel Marklund / BILDBYRÅN",
      "created": "2019-02-26T16:22:21+01:00"
    },
    {
      "id": "190228JM024",
      "caption": "190228 Ebba Andersson, Frida Karlsson, Charlotte Kalla and Stina Nilsson of Sweden celebrates after women's 4 x 5km relay during the FIS Nordic World Ski Championships on February 28, 2019 in Seefeld in Tirol.nPhoto: Joel Marklund / BILDBYRÅN / kod JM / 87902",
      "photographer": "Joel Marklund / BILDBYRÅN",
      "created": "2019-02-28T14:00:18+01:00"
    },
    {
      "id": "190228JM041",
      "caption": "190228 Ebba Andersson, Frida Karlsson, Charlotte Kalla and Stina Nilsson of Sweden celebrates after women's 4 x 5km relay during the FIS Nordic World Ski Championships on February 28, 2019 in Seefeld in Tirol.rPhoto: Joel Marklund / BILDBYRÅN / kod JM / 87902",
      "photographer": "Joel Marklund / BILDBYRÅN",
      "created": "2019-02-28T14:21:20+01:00"
    },
    {
      "id": "190225DS014",
      "caption": "190225 IFK Göteborgs supportrar med pyroteknik under fotbollsmatchen i Svenska Cupen mellan IFK Göteborg och Gais den 25 februari 2019 i Göteborg. rFoto: Daniel Stiller / Bildbyrån / kod DS / 59319",
      "photographer": "Daniel Stiller / BILDBYRÅN",
      "created": "2019-02-25T21:05:53+01:00"
    }
  ]
}



Attribute Description
id Unique identifier for the photo.
caption Caption for this photo.
photographer Photographer name
created Date when photo was taken in ISO 8601 format