Albums

The Albums resource represents photo albums created by users. Each album belongs to a user and can contain multiple photos.

Base URL

Public API

https://api.jsonplaceholder.dev

Local Development

http://localhost:3000

Schema

interface Album {
  id: number
  userId: number
  title: string
}

Endpoints

Get All Albums

GET /albums

Response:

[
  {
    "userId": 1,
    "id": 1,
    "title": "quidem molestiae enim"
  }
  // ... 99 more albums
]

Get Albums by User

GET /albums?userId={userId}

Parameters:

• userId (number, query) - Filter albums by user ID

Response:

[
  {
    "userId": 1,
    "id": 1,
    "title": "quidem molestiae enim"
  }
  // ... more albums by user 1
]

Get Single Album

GET /albums/{id}

Parameters:

• id (number) - Album ID

Response:

{
  "userId": 1,
  "id": 1,
  "title": "quidem molestiae enim"
}

Get Album Photos

GET /albums/{id}/photos

Parameters:

• id (number) - Album ID

Response:

[
  {
    "albumId": 1,
    "id": 1,
    "title": "accusamus beatae ad facilis cum similique qui sunt",
    "url": "https://via.placeholder.com/600/92c952",
    "thumbnailUrl": "https://via.placeholder.com/150/92c952"
  }
  // ... more photos in this album
]

Create Album

POST /albums

Request Body:

{
  "userId": 1,
  "title": "My Photo Album"
}

Response: 201 Created

{
  "id": 101,
  "userId": 1,
  "title": "My Photo Album"
}

Update Album (Full Replace)

PUT /albums/{id}

Parameters:

• id (number) - Album ID

Request Body:

{
  "userId": 1,
  "title": "Updated Album Title"
}

Response: 200 OK

{
  "id": 1,
  "userId": 1,
  "title": "Updated Album Title"
}

Update Album (Partial)

PATCH /albums/{id}

Parameters:

• id (number) - Album ID

Request Body: Partial album object

{
  "title": "New Album Name"
}

Response: 200 OK - Updated album object

Delete Album

DELETE /albums/{id}

Parameters:

• id (number) - Album ID

Response: 200 OK

{}

Examples

JavaScript/Fetch

// Get all albums
const albums = await fetch('http://localhost:3000/albums')
  .then(res => res.json());

// Get albums by user
const userAlbums = await fetch('http://localhost:3000/albums?userId=1')
  .then(res => res.json());

// Get album photos
const photos = await fetch('http://localhost:3000/albums/1/photos')
  .then(res => res.json());

// Create new album
const newAlbum = await fetch('http://localhost:3000/albums', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    userId: 1,
    title: 'Vacation Photos 2025'
  })
}).then(res => res.json());

// Update album
const updatedAlbum = await fetch('http://localhost:3000/albums/1', {
  method: 'PATCH',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    title: 'Summer Vacation 2025'
  })
}).then(res => res.json());

cURL

# Get all albums
curl http://localhost:3000/albums

# Get albums by user
curl http://localhost:3000/albums?userId=1

# Get album photos
curl http://localhost:3000/albums/1/photos

# Create new album
curl -X POST http://localhost:3000/albums \
  -H "Content-Type: application/json" \
  -d '{
    "userId": 1,
    "title": "Vacation Photos 2025"
  }'

# Update album
curl -X PATCH http://localhost:3000/albums/1 \
  -H "Content-Type: application/json" \
  -d '{"title": "Summer Vacation 2025"}'

# Delete album
curl -X DELETE http://localhost:3000/albums/1

Python

import requests

# Get all albums
albums = requests.get('http://localhost:3000/albums').json()

# Get albums by user
user_albums = requests.get('http://localhost:3000/albums?userId=1').json()

# Get album photos
photos = requests.get('http://localhost:3000/albums/1/photos').json()

# Create new album
new_album = requests.post('http://localhost:3000/albums', json={
    'userId': 1,
    'title': 'Vacation Photos 2025'
}).json()

# Update album
updated_album = requests.patch('http://localhost:3000/albums/1', json={
    'title': 'Summer Vacation 2025'
}).json()

# Delete album
requests.delete('http://localhost:3000/albums/1')

Related Resources

• Users - The owner of the album
• Photos - Photos contained in the album