API Documentation
All endpoints require apikey parameter. Base URL: https://api.bildbyran.se
Endpoints
GET
List the latest image albums
List the most recent image albums (events) in the database.
GET https://api.bildbyran.se/v1/albums?apikey=YOUR_KEY
Parameters
| Parameter | Example | Description |
|---|---|---|
| limit | 100 | Maximum results to return (default 100, max 1000) |
| offset | 0 | Start position for paging |
Response Fields
| Field | Description |
|---|---|
| cover | Photo ID of the album cover image |
| id | Unique album identifier |
| name | Album title |
Example Response
{
"albums": [
{
"cover": "260206JZ013",
"id": "JZ0674",
"name": "Football, Atlantic Cup 2026, IFK Göteborg - Artis Brno"
}
]
}
GET
List the most recent photos
List the most recent images added to the database.
GET https://api.bildbyran.se/v1/photos?apikey=YOUR_KEY
Parameters
| Parameter | Example | Description |
|---|---|---|
| limit | 100 | Maximum results to return (default 100, max 1000) |
| offset | 0 | Start position for paging |
Response Fields
| Field | Description |
|---|---|
| id | Unique photo identifier |
| caption | Photo caption |
| photographer | Photographer name |
| created | Date taken in ISO 8601 format |
Example Response
{
"photos": [
{
"id": "260206JZ013",
"caption": "260206 Football, Atlantic Cup...",
"photographer": "Jesper Zerman / BILDBYRÅN",
"created": "2026-02-06T15:07:09+01:00"
}
]
}
GET
Search for photos
Search for photos matching a query string. Supports date and datetime filtering.
GET https://api.bildbyran.se/v1/photos?q=searchstring?apikey=YOUR_KEY
Parameters
| Parameter | Example | Description |
|---|---|---|
| q | Zlatan Ibrahimovic | Search query |
| fromdate | 20260129 or 2026-01-29T08:00:00Z | Filter photos newer than this date or datetime (ISO 8601) |
| todate | 20260129 or 2026-01-29T18:00:00Z | Filter photos older than this date or datetime (ISO 8601) |
| limit | 100 | Maximum results (default 100, max 1000) |
| offset | 0 | Start position for paging |
Response Fields
| Field | Description |
|---|---|
| id | Unique photo identifier |
| caption | Full photo caption |
| shortcaption | Shortened caption |
| photographer | Photographer name |
| created | Date taken in ISO 8601 format |
| size | Total number of matching results |
Example Response
{
"photos": [
{
"id": "181221JM006",
"caption": "181221 This picture is part of...",
"shortcaption": "Zlatan Ibrahimovic, player of LA Galaxy...",
"photographer": "Joel Marklund / BILDBYRÅN",
"created": "2018-03-29T15:56:19+02:00"
}
],
"size": 19055
}
GET
Browse an image album
Browse images in a specific album (event).
GET https://api.bildbyran.se/v1/photos?albumid=AI180926_48a?apikey=YOUR_KEY
Parameters
| Parameter | Example | Description |
|---|---|---|
| albumid | AI180926_48a | Unique album identifier |
| limit | 100 | Maximum results (default 100, max 1000) |
| offset | 0 | Start position for paging |
Response Fields
| Field | Description |
|---|---|
| id | Unique photo identifier |
| caption | Photo caption |
| shortcaption | Shortened caption |
| photographer | Photographer name |
| created | Date taken in ISO 8601 format |
| size | Total photos in album |
Example Response
{
"photos": [
{
"id": "190303ZA018",
"caption": "190303 Fotboll, Franska Ligan...",
"shortcaption": "Andrei Girotto of Nantes...",
"photographer": "Vincent Michel / BILDBYRÅN",
"created": "2019-03-03T16:28:32+01:00"
}
],
"size": 16
}
GET
Get an image thumbnail
Retrieve a thumbnail of a photo. Returns JPEG image data.
GET https://api.bildbyran.se/v1/photos/{id}/thumbnail?apikey=YOUR_KEY
Returns image/jpeg binary data directly.
Parameters
| Parameter | Example | Description |
|---|---|---|
| size | 537x358 | Thumbnail size: 537x358 or 1920x1280 |
GET
Download a full-size image
Download a full resolution image. Returns JPEG image data.
GET https://api.bildbyran.se/v1/photos/{id}/download?apikey=YOUR_KEY
Returns image/jpeg binary data directly. Downloads are logged.
Parameters
| Parameter | Example | Description |
|---|---|---|
| size | max | Image size: 1920x1280 or max (full resolution) |
GET
Get a download link
Returns a direct download URL for the image. Useful for passing to other systems.
GET https://api.bildbyran.se/v1/photos/{id}/downloadLink?apikey=YOUR_KEY
Parameters
| Parameter | Example | Description |
|---|---|---|
| size | max | Image size: 1920x1280 or max |
Response Fields
| Field | Description |
|---|---|
| url | Direct download URL including authentication |
Example Response
{
"url": "https://api.bildbyran.se/v1/photos/170511JM001/download?apikey=...&size=max"
}
GET
Get photo metadata
Retrieve full metadata for a specific photo.
GET https://api.bildbyran.se/v1/photos/{id}?apikey=YOUR_KEY
Response Fields
| Field | Description |
|---|---|
| id | Unique photo identifier |
| width | Width in pixels |
| height | Height in pixels |
| orientation | 1 = horizontal, 2 = square, 3 = vertical |
| filesize | File size in bytes |
| created | Date taken in ISO 8601 format |
| city | City where photo was taken |
| country | Country where photo was taken |
| objectname | Album/event name |
| category | SPO (sport) or ALL (general) |
| albumid | Album identifier |
| caption | Full photo caption |
| photographer | Photographer name |
| keywords | Search keywords separated by semicolons |
Example 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, Sverige - Lettland",
"category": "SPO",
"albumid": "87446",
"caption": "170511 Sveriges Marcus Krüger...",
"photographer": "Joel Marklund",
"keywords": "ishockey;ice hockey;iihf world championship;vm"
}
GET
Most popular photos
List the most downloaded photos over a recent time period.
GET https://api.bildbyran.se/v1/photos?sorting=popularity?apikey=YOUR_KEY
Parameters
| Parameter | Example | Description |
|---|---|---|
| days | 7 | Lookback period in days (1-7, default 7) |
| limit | 100 | Maximum results (default 100, max 1000) |
| offset | 0 | Start position for paging |
Response Fields
| Field | Description |
|---|---|
| id | Unique photo identifier |
| caption | Photo caption |
| photographer | Photographer name |
| created | Date taken in ISO 8601 format |
Example Response
{
"photos": [
{
"id": "260204JM016",
"caption": "260204 Winter Olympics...",
"photographer": "Joel Marklund / BILDBYRÅN",
"created": "2026-02-04T14:22:21+01:00"
}
]
}
GET
Batch photo metadata
Retrieve full metadata for multiple photos in a single request. Pass photo IDs as a comma-separated list. Maximum 100 IDs per request.
GET https://api.bildbyran.se/v1/photos/batch-info?apikey=YOUR_KEY
Pass IDs as comma-separated list in the ids parameter. Maximum 100 IDs per request.
Parameters
| Parameter | Example | Description |
|---|---|---|
| ids | Comma-separated list of photo IDs | 1 |
Response Fields
| Field | Description |
|---|---|
| id | Unique photo identifier |
| width | Width in pixels |
| height | Height in pixels |
| orientation | 1 = horizontal, 2 = square, 3 = vertical |
| filesize | File size in bytes |
| created | Date taken in ISO 8601 format |
| city | City where photo was taken |
| country | Country where photo was taken |
| objectname | Album/event name |
| category | SPO (sport) or ALL (general) |
| albumid | Album identifier |
| caption | Full photo caption |
| photographer | Photographer name |
| keywords | Search keywords separated by semicolons |
Example Response
GET /v1/photos/batch-info?ids=170511JM001,181221JM006,190303ZM026&apikey=YOUR_KEY
// Response:
{
"photos": [
{
"id": "170511JM001",
"width": 5288,
"height": 3525,
"created": "2017-05-11T19:36:51+02:00",
"photographer": "Joel Marklund",
...
},
{
"id": "181221JM006",
...
}
]
}