- What is Unsplash API?
- Getting Started
- API Request Limits
- HTTP Verbs & Error Messages
- Photos 📷
- Search 🔍
- Collection 🗂️
- Topics 🗒
Collection By ID
GET
https://api.unsplash.com/collections
Request
Query Params
id
integer
required
Example:
8
client_id
integer
required
Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.unsplash.com/collections?id=8&client_id='Responses
🟢200OK
application/json
Body
array of:
id
string
required
title
string
required
description
string | null
required
published_at
string
required
last_collected_at
string
required
updated_at
string
required
featured
boolean
required
total_photos
integer
required
private
boolean
required
share_key
string
required
tags
array [object {3}]
required
type
string
required
title
string
required
source
object
required
links
object
required
self
string
required
html
string
required
photos
string
required
related
string
required
user
object
required
id
string
required
updated_at
string
required
username
string
required
name
string
required
first_name
string
required
last_name
string
required
twitter_username
string | null
required
portfolio_url
string | null
required
bio
string | null
required
location
string | null
required
links
object
required
profile_image
object
required
instagram_username
string | null
required
total_collections
integer
required
total_likes
integer
required
total_photos
integer
required
total_promoted_photos
integer
required
accepted_tos
boolean
required
for_hire
boolean
required
social
object
required
cover_photo
object
required
id
string
required
slug
string
required
alternative_slugs
object
required
created_at
string
required
updated_at
string
required
promoted_at
string | null
required
width
integer
required
height
integer
required
color
string
required
blur_hash
string | null
required
description
string | null
required
alt_description
string
required
breadcrumbs
array [object {4}]
required
urls
object
required
links
object
required
likes
integer
required
liked_by_user
boolean
required
current_user_collections
array[string]
required
sponsorship
null
required
topic_submissions
object
required
asset_type
string
required
user
object
required
preview_photos
array [object {7}]
required
id
string
required
slug
string
required
created_at
string
required
updated_at
string
required
blur_hash
string | null
required
asset_type
string
required
urls
object
required
Example
[
{
"id": "string",
"title": "string",
"description": "string",
"published_at": "string",
"last_collected_at": "string",
"updated_at": "string",
"featured": true,
"total_photos": 0,
"private": true,
"share_key": "string",
"tags": [
{
"type": "string",
"title": "string",
"source": {
"ancestry": {
"type": {
"slug": "string",
"pretty_slug": "string"
},
"category": {
"slug": "string",
"pretty_slug": "string"
},
"subcategory": {
"slug": "string",
"pretty_slug": "string"
}
},
"title": "string",
"subtitle": "string",
"description": "string",
"meta_title": "string",
"meta_description": "string",
"cover_photo": {
"id": "string",
"slug": "string",
"alternative_slugs": {
"en": "string",
"es": "string",
"ja": "string",
"fr": "string",
"it": "string",
"ko": "string",
"de": "string",
"pt": "string"
},
"created_at": "string",
"updated_at": "string",
"promoted_at": "string",
"width": 0,
"height": 0,
"color": "string",
"blur_hash": "string",
"description": "string",
"alt_description": "string",
"breadcrumbs": [
{
"slug": "string",
"title": "string",
"index": 0,
"type": "string"
}
],
"urls": {
"raw": "string",
"full": "string",
"regular": "string",
"small": "string",
"thumb": "string",
"small_s3": "string"
},
"links": {
"self": "string",
"html": "string",
"download": "string",
"download_location": "string"
},
"likes": 0,
"liked_by_user": true,
"current_user_collections": [
"string"
],
"sponsorship": null,
"topic_submissions": {
"health": {
"status": "string",
"approved_on": "string"
},
"nature": {
"status": "string",
"approved_on": "string"
},
"wallpapers": {
"status": "string",
"approved_on": "string"
},
"architecture-interior": {
"status": "string",
"approved_on": "string"
},
"color-of-water": {
"status": "string",
"approved_on": "string"
},
"textures-patterns": {
"status": "string",
"approved_on": "string"
},
"animals": {
"status": "string",
"approved_on": "string"
}
},
"asset_type": "string",
"premium": true,
"plus": true,
"user": {
"id": "string",
"updated_at": "string",
"username": "string",
"name": "string",
"first_name": "string",
"last_name": "string",
"twitter_username": "string",
"portfolio_url": "string",
"bio": "string",
"location": "string",
"links": {
"self": "string",
"html": "string",
"photos": "string",
"likes": "string",
"portfolio": "string",
"following": "string",
"followers": "string"
},
"profile_image": {
"small": "string",
"medium": "string",
"large": "string"
},
"instagram_username": "string",
"total_collections": 0,
"total_likes": 0,
"total_photos": 0,
"total_promoted_photos": 0,
"accepted_tos": true,
"for_hire": true,
"social": {
"instagram_username": "string",
"portfolio_url": "string",
"twitter_username": "string",
"paypal_email": null
}
}
}
}
}
],
"links": {
"self": "string",
"html": "string",
"photos": "string",
"related": "string"
},
"user": {
"id": "string",
"updated_at": "string",
"username": "string",
"name": "string",
"first_name": "string",
"last_name": "string",
"twitter_username": "string",
"portfolio_url": "string",
"bio": "string",
"location": "string",
"links": {
"self": "string",
"html": "string",
"photos": "string",
"likes": "string",
"portfolio": "string",
"following": "string",
"followers": "string"
},
"profile_image": {
"small": "string",
"medium": "string",
"large": "string"
},
"instagram_username": "string",
"total_collections": 0,
"total_likes": 0,
"total_photos": 0,
"total_promoted_photos": 0,
"accepted_tos": true,
"for_hire": true,
"social": {
"instagram_username": "string",
"portfolio_url": "string",
"twitter_username": "string",
"paypal_email": null
}
},
"cover_photo": {
"id": "string",
"slug": "string",
"alternative_slugs": {
"en": "string",
"es": "string",
"ja": "string",
"fr": "string",
"it": "string",
"ko": "string",
"de": "string",
"pt": "string"
},
"created_at": "string",
"updated_at": "string",
"promoted_at": "string",
"width": 0,
"height": 0,
"color": "string",
"blur_hash": "string",
"description": "string",
"alt_description": "string",
"breadcrumbs": [
{
"slug": "string",
"title": "string",
"index": 0,
"type": "string"
}
],
"urls": {
"raw": "string",
"full": "string",
"regular": "string",
"small": "string",
"thumb": "string",
"small_s3": "string"
},
"links": {
"self": "string",
"html": "string",
"download": "string",
"download_location": "string"
},
"likes": 0,
"liked_by_user": true,
"current_user_collections": [
"string"
],
"sponsorship": null,
"topic_submissions": {
"architecture-interior": {
"status": "string"
},
"wallpapers": {
"status": "string",
"approved_on": "string"
},
"health": {
"status": "string"
},
"cool-tones": {
"status": "string",
"approved_on": "string"
},
"3d-renders": {
"status": "string",
"approved_on": "string"
},
"nature": {
"status": "string",
"approved_on": "string"
},
"spirituality": {
"status": "string",
"approved_on": "string"
},
"experimental": {
"status": "string",
"approved_on": "string"
}
},
"asset_type": "string",
"user": {
"id": "string",
"updated_at": "string",
"username": "string",
"name": "string",
"first_name": "string",
"last_name": "string",
"twitter_username": "string",
"portfolio_url": "string",
"bio": "string",
"location": "string",
"links": {
"self": "string",
"html": "string",
"photos": "string",
"likes": "string",
"portfolio": "string",
"following": "string",
"followers": "string"
},
"profile_image": {
"small": "string",
"medium": "string",
"large": "string"
},
"instagram_username": "string",
"total_collections": 0,
"total_likes": 0,
"total_photos": 0,
"total_promoted_photos": 0,
"accepted_tos": true,
"for_hire": true,
"social": {
"instagram_username": "string",
"portfolio_url": "string",
"twitter_username": "string",
"paypal_email": null
}
}
},
"preview_photos": [
{
"id": "string",
"slug": "string",
"created_at": "string",
"updated_at": "string",
"blur_hash": "string",
"asset_type": "string",
"urls": {
"raw": "string",
"full": "string",
"regular": "string",
"small": "string",
"thumb": "string",
"small_s3": "string"
}
}
]
}
]Modified at 2024-04-08 16:54:24