- What is Unsplash API?
- Getting Started
- API Request Limits
- HTTP Verbs & Error Messages
- Photos 📷
- Search 🔍
- Collection 🗂️
- Topics 🗒
Search Users
GET
https://api.unsplash.com/search/users
Request
Query Params
page
number
required
Example:
1
query
string
required
Example:
Evans
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/search/users?page=1&query=Evans&client_id='Responses
🟢200Success
application/json
Body
Additional properties
integer | number | string | boolean
optional
Example
{
"total": 8042,
"total_pages": 805,
"results": [
{
"id": "VCAwa4voJRs",
"updated_at": "2024-04-08T12:39:40Z",
"username": "anevans",
"name": "Anna Evans",
"first_name": "Anna",
"last_name": "Evans",
"twitter_username": null,
"portfolio_url": null,
"bio": null,
"location": null,
"links": {
"self": "https://api.unsplash.com/users/anevans",
"html": "https://unsplash.com/@anevans",
"photos": "https://api.unsplash.com/users/anevans/photos",
"likes": "https://api.unsplash.com/users/anevans/likes",
"portfolio": "https://api.unsplash.com/users/anevans/portfolio",
"following": "https://api.unsplash.com/users/anevans/following",
"followers": "https://api.unsplash.com/users/anevans/followers"
},
"profile_image": {
"small": "https://images.unsplash.com/profile-1651567829601-d7f4568699e8image?ixlib=rb-4.0.3&crop=faces&fit=crop&w=32&h=32",
"medium": "https://images.unsplash.com/profile-1651567829601-d7f4568699e8image?ixlib=rb-4.0.3&crop=faces&fit=crop&w=64&h=64",
"large": "https://images.unsplash.com/profile-1651567829601-d7f4568699e8image?ixlib=rb-4.0.3&crop=faces&fit=crop&w=128&h=128"
},
"instagram_username": null,
"total_collections": 31,
"total_likes": 28,
"total_photos": 393,
"total_promoted_photos": 0,
"accepted_tos": true,
"for_hire": true,
"social": {
"instagram_username": null,
"portfolio_url": null,
"twitter_username": null,
"paypal_email": null
},
"followed_by_user": false,
"photos": [
{
"id": "5fdgxlNNxcg",
"slug": "a-cat-sitting-on-top-of-a-blue-cushion-5fdgxlNNxcg",
"created_at": "2022-06-09T08:26:23Z",
"updated_at": "2024-04-02T20:20:49Z",
"blur_hash": "LGG8~00Ktm%2==tQads,KSt7s.NH",
"asset_type": "photo",
"urls": {
"raw": "https://images.unsplash.com/photo-1654762939512-6790bfd559a0?ixlib=rb-4.0.3",
"full": "https://images.unsplash.com/photo-1654762939512-6790bfd559a0?ixlib=rb-4.0.3&q=85&fm=jpg&crop=entropy&cs=srgb",
"regular": "https://images.unsplash.com/photo-1654762939512-6790bfd559a0?ixlib=rb-4.0.3&q=80&fm=jpg&crop=entropy&cs=tinysrgb&w=1080&fit=max",
"small": "https://images.unsplash.com/photo-1654762939512-6790bfd559a0?ixlib=rb-4.0.3&q=80&fm=jpg&crop=entropy&cs=tinysrgb&w=400&fit=max",
"thumb": "https://images.unsplash.com/photo-1654762939512-6790bfd559a0?ixlib=rb-4.0.3&q=80&fm=jpg&crop=entropy&cs=tinysrgb&w=200&fit=max",
"small_s3": "https://s3.us-west-2.amazonaws.com/images.unsplash.com/small/photo-1654762939512-6790bfd559a0"
}
},
{
"id": "K7ne3GJ1D38",
"slug": "a-group-of-brown-round-objects-K7ne3GJ1D38",
"created_at": "2022-10-23T08:14:16Z",
"updated_at": "2024-04-07T23:57:18Z",
"blur_hash": "LoKKWkt7%gV?L}RjMxoz.8f+WBWB",
"asset_type": "photo",
"urls": {
"raw": "https://images.unsplash.com/photo-1666512834316-b4ab32f0e313?ixlib=rb-4.0.3",
"full": "https://images.unsplash.com/photo-1666512834316-b4ab32f0e313?ixlib=rb-4.0.3&q=85&fm=jpg&crop=entropy&cs=srgb",
"regular": "https://images.unsplash.com/photo-1666512834316-b4ab32f0e313?ixlib=rb-4.0.3&q=80&fm=jpg&crop=entropy&cs=tinysrgb&w=1080&fit=max",
"small": "https://images.unsplash.com/photo-1666512834316-b4ab32f0e313?ixlib=rb-4.0.3&q=80&fm=jpg&crop=entropy&cs=tinysrgb&w=400&fit=max",
"thumb": "https://images.unsplash.com/photo-1666512834316-b4ab32f0e313?ixlib=rb-4.0.3&q=80&fm=jpg&crop=entropy&cs=tinysrgb&w=200&fit=max",
"small_s3": "https://s3.us-west-2.amazonaws.com/images.unsplash.com/small/photo-1666512834316-b4ab32f0e313"
}
},
{
"id": "B2R4jFnRT7E",
"slug": "a-close-up-of-some-fruit-B2R4jFnRT7E",
"created_at": "2022-07-31T10:20:08Z",
"updated_at": "2024-04-03T09:56:27Z",
"blur_hash": "LBB|pGxtV?V{_LtQRloP-.aiIqtR",
"asset_type": "photo",
"urls": {
"raw": "https://images.uModified at 2024-04-08 16:30:59