Unsplash API

https://unsplash.com/documentation
Admin
The Unsplash API provides access to millions of free, high-resolution photos for developers to use...
Tokens:56,890
Snippets:211
Trust Score:10
Update:1 month ago
Show doc for...
Tokens:
Raw
### User Profile Response Example

Source: https://unsplash.com/documentation

This is an example of a successful response (200 OK) when retrieving a user's public profile. It includes user details and links.

```json
{
  "id": "pXhwzz1JtQU",
  "updated_at": "2016-07-10T11:00:01-05:00",
  "username": "jimmyexample",
  "name": "James Example",
  "first_name": "James",
  "last_name": "Example",
  "instagram_username": "instantgrammer",
  "twitter_username": "jimmy",
  "portfolio_url": null,
  "bio": "The user's bio",
  "location": "Montreal, Qc",
  "total_collections": 5,
  "downloads": 225974,
  "social": {
    "instagram_username": "instantgrammer",
    "portfolio_url": "",
    "twitter_username": "jimmy"
  },
  "profile_image": {
    "small": "https://images.unsplash.com/face-springmorning.jpg?q=80&fm=jpg&crop=faces&fit=crop&h=32&w=32",
    "medium": "https://images.unsplash.com/face-springmorning.jpg?q=80&fm=jpg&crop=faces&fit=crop&h=64&w=64",
    "large": "https://images.unsplash.com/face-springmorning.jpg?q=80&fm=jpg&crop=faces&fit=crop&h=128&w=128"
  },
  "badge": {
    "title": "Book contributor",
    "primary": true,
    "slug": "book-contributor",
    "link": "https://book.unsplash.com"
  },
  "links": {
    "self": "https://api.unsplash.com/users/jimmyexample",
    "html": "https://unsplash.com/jimmyexample",
    "photos": "https://api.unsplash.com/users/jimmyexample/photos"
  }
}
```

--------------------------------

### Topic Response Example

Source: https://unsplash.com/documentation

This is an example of a successful response when retrieving topic data. It includes details like ID, slug, title, and links to related resources.

```json
[
  {
    "id": "bo8jQKTaE0Y",
    "slug": "wallpapers",
    "title": "Wallpapers",
    "description": "From epic drone shots to inspiring moments in nature, find free HD wallpapers worthy of your mobile and desktop screens. Finally.",
    "published_at": "2020-04-17T02:31:04Z",
    "updated_at": "2020-09-22T07:37:55-04:00",
    "starts_at": "2020-04-15T00:00:00Z",
    "ends_at": null,
    "only_submissions_after": null,
    "visibility": "featured",
    "featured": true,
    "total_photos": 5296,
    "links": {
      "self": "https://api.unsplash.com/topics/wallpapers",
      "html": "https://unsplash.com/t/wallpapers",
      "photos": "https://api.unsplash.com/topics/wallpapers/photos"
    },
    "status": "open",
    "owners": [
      {
        "id": "QV5S1rtoUJ0",
        "updated_at": "2020-09-22T10:49:58-04:00",
        "username": "unsplash",
        "name": "Unsplash",
        "first_name": "Unsplash",
        "last_name": null,
        "twitter_username": "unsplash",
        "portfolio_url": "https://unsplash.com",
        "bio": "Behind the scenes of the team building the internet’s open library of freely useable visuals.",
        "location": "Montreal, Canada",
        "links": {
          "self": "https://api.unsplash.com/users/unsplash",
          "html": "https://unsplash.com/@unsplash",
          "photos": "https://api.unsplash.com/users/unsplash/photos"
        },
        "profile_image": {
          "small": "https://images.unsplash.com/profile-1544707963613-16baf868f301?ixlib=rb-1.2.1&q=80&fm=jpg&crop=faces&cs=tinysrgb&fit=crop&h=32&w=32",
          "medium": "https://images.unsplash.com/profile-1544707963613-16baf868f301?ixlib=rb-1.2.1&q=80&fm=jpg&crop=faces&cs=tinysrgb&fit=crop&h=64&w=64",
          "large": "https://images.unsplash.com/profile-1544707963613-16baf868f301?ixlib=rb-1.2.1&q=80&fm=jpg&crop=faces&cs=tinysrgb&fit=crop&h=128&w=128"
        },
        "instagram_username": "unsplash",
        "total_collections": 22,
        "accepted_tos": true
      }
    ],
    "current_user_contributions": [],
    "total_current_user_submissions": {},
    "cover_photo": {
      "id": "0q_YtRanczI",
      "created_at": "2018-10-26T03:24:18-04:00",
      "updated_at": "2020-06-21T01:10:35-04:00",
      "promoted_at": null,
      "width": 3992,
      "height": 2992,
      "color": "#CBCAC8",
      "blur_hash": "LEBpFJRk5TR+5toJ^ia#0KfPIoxY",
      "description": "Greek villa by the coast",
      "alt_description": "aerial view of city",
      "urls": {
        "raw": "https://images.unsplash.com/photo-1540538581514-1d465aaad58c?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9",
        "full": "https://images.unsplash.com/photo-1540538581514-1d465aaad58c?ixlib=rb-1.2.1&q=85&fm=jpg&crop=entropy&cs=srgb&ixid=eyJhcHBfaWQiOjEyMDd9",
        "regular": "https://images.unsplash.com/photo-1540538581514-1d465aaad58c?ixlib=rb-1.2.1&q=80&fm=jpg&crop=entropy&cs=tinysrgb&w=1080&fit=max&ixid=eyJhcHBfaWQiOjEyMDd9",
        "small": "https://images.unsplash.com/photo-1540538581514-1d465aaad58c?ixlib=rb-1.2.1&q=80&fm=jpg&crop=entropy&cs=tinysrgb&w=400&fit=max&ixid=eyJhcHBfaWQiOjEyMDd9",
        "thumb": "https://images.unsplash.com/photo-1540538581514-1d465aaad58c?ixlib=rb-1.2.1&q=80&fm=jpg&crop=entropy&cs=tinysrgb&w=200&fit=max&ixid=eyJhcHBfaWQiOjEyMDd9"
      },
      "links": {
        "self": "https://api.unsplash.com/photos/0q_YtRanczI",
        "html": "https://unsplash.com/photos/0q_YtRanczI",
        "download": "https://unsplash.com/photos/0q_YtRanczI/download",
        "download_location": "https://api.unsplash.com/photos/0q_YtRanczI/download"
      },
      "user": {
        "id": "QV5S1rtoUJ0",
        "updated_at": "2020-09-22T10:49:58-04:00",
        "username": "unsplash",
        "name": "Unsplash",
        "first_name": "Unsplash",
        "last_name": null,
        "twitter_username": "unsplash",
        "portfolio_url": "https://unsplash.com",
        "bio": "Behind the scenes of the team building the internet’s open library of freely useable visuals."
      }
    }
  }
]
```

--------------------------------

### User Collections Response Example

Source: https://unsplash.com/documentation

This is an example of a successful response (200 OK) when listing a user's collections. It includes pagination links and rate limit information.

```http
200 OK
Link: <https://api.unsplash.com/users/fableandfolk/collections>; rel="first", <https://api.unsplash.com/photos/users/fableandfolk/collections?page=1>; rel="prev", <https://api.unsplash.com/photos/users/fableandfolk/collections?page=5>; rel="last", <https://api.unsplash.com/photos/users/fableandfolk/collections?page=3>; rel="next"
X-Ratelimit-Limit: 1000
X-Ratelimit-Remaining: 999
```

--------------------------------

### Collection Search Response Example

Source: https://unsplash.com/documentation

This is an example of a successful HTTP response when searching for collections. It includes pagination links and rate limit information.

```http
200 OK
Link: <https://api.unsplash.com/search/collections?page=1&query=office>; rel="first", <https://api.unsplash.com/search/collections?page=1&query=office>; rel="prev", <https://api.unsplash.com/search/collections?page=3&query=office>; rel="last", <https://api.unsplash.com/search/collections?page=3&query=office>; rel="next"
X-Ratelimit-Limit: 1000
X-Ratelimit-Remaining: 999
```

--------------------------------

### API Response Headers Example

Source: https://unsplash.com/documentation

This example shows typical HTTP headers returned with a successful API response, including rate limiting information and pagination links.

```HTTP
200 OK
Link: <https://api.unsplash.com/topics?page=3>; rel="last", <https://api.unsplash.com/topics?page=2>; rel="next"
X-Ratelimit-Limit: 1000
X-Ratelimit-Remaining: 999
```

--------------------------------

### List Photos - Response Body

Source: https://unsplash.com/documentation

Example JSON response body for the List Photos endpoint, showing abbreviated photo objects. For full details, use GET /photos/:id.

```json
[
  {
    "id": "LBI7cgq3pbM",
    "created_at": "2016-05-03T11:00:28-04:00",
    "updated_at": "2016-07-10T11:00:01-05:00",
    "width": 5245,
    "height": 3497,
    "color": "#60544D",
    "blur_hash": "LoC%a7IoIVxZ_NM|M{s:%hRjWAo0",
    "description": "A man drinking a coffee.",
    "user": {
      "id": "pXhwzz1JtQU",
      "username": "poorkane",
      "name": "Gilbert Kane",
      "portfolio_url": "https://theylooklikeeggsorsomething.com/",
      "bio": "XO",
      "location": "Way out there",
      "total_collections": 52,
      "instagram_username": "instantgrammer",
      "twitter_username": "crew",
      "profile_image": {
        "small": "https://images.unsplash.com/face-springmorning.jpg?q=80&fm=jpg&crop=faces&fit=crop&h=32&w=32",
        "medium": "https://images.unsplash.com/face-springmorning.jpg?q=80&fm=jpg&crop=faces&fit=crop&h=64&w=64",
        "large": "https://images.unsplash.com/face-springmorning.jpg?q=80&fm=jpg&crop=faces&fit=crop&h=128&w=128"
      },
      "links": {
        "self": "https://api.unsplash.com/users/poorkane",
        "html": "https://unsplash.com/poorkane",
        "photos": "https://api.unsplash.com/users/poorkane/photos"
      }
    },
    "current_user_collections": [ 
      {
        "id": 206,
        "title": "Makers: Cat and Ben",
        "published_at": "2016-01-12T18:16:09-05:00",
        "last_collected_at": "2016-06-02T13:10:03-04:00",
        "updated_at": "2016-07-10T11:00:01-05:00",
        "cover_photo": null,
        "user": null
      },
      // ... more collections
    ],
    "urls": {
      "raw": "https://images.unsplash.com/face-springmorning.jpg",
      "full": "https://images.unsplash.com/face-springmorning.jpg?q=75&fm=jpg",
      "regular": "https://images.unsplash.com/face-springmorning.jpg?q=75&fm=jpg&w=1080&fit=max",
      "small": "https://images.unsplash.com/face-springmorning.jpg?q=75&fm=jpg&w=400&fit=max",
      "thumb": "https://images.unsplash.com/face-springmorning.jpg?q=75&fm=jpg&w=200&fit=max"
    },
    "links": {
      "self": "https://api.unsplash.com/photos/LBI7cgq3pbM",
      "html": "https://unsplash.com/photos/LBI7cgq3pbM",
      "download": "https://unsplash.com/photos/LBI7cgq3pbM/download",
      "download_location": "https://api.unsplash.com/photos/LBI7cgq3pbM/download"
    }
  },
  // ... more photos
]

```

--------------------------------

### Example Response for Related Collections

Source: https://unsplash.com/documentation

This is an example of a successful response (200 OK) when listing related collections. It includes rate limiting headers and a JSON array of collection objects.

```json
[ 
  {
    "id": 296,
    "title": "I like a man with a beard.",
    "description": "Yeah even Santa...",
    "published_at": "2016-01-27T18:47:13-05:00",
    "last_collected_at": "2016-06-02T13:10:03-04:00",
    "updated_at": "2016-07-10T11:00:01-05:00",
    "total_photos": 12,
    "private": false,
    "share_key": "312d188df257b957f8b86d2ce20e4766",
    "cover_photo": {
      "id": "C-mxLOk6ANs",
      "width": 5616,
      "height": 3744,
      "color": "#E4C6A2",
      "blur_hash": "L57Uhwni00t7EeRkagj@s+kBxvoe",
      "description": "A man drinking a coffee.",
      "user": {
        "id": "xlt1-UPW7FE",
        "username": "lionsdenpro",
        "name": "Greg Raines",
        "portfolio_url": "https://example.com/",
        "bio": "Just an everyday Greg",
        "location": "Montreal",
        "total_collections": 13,
        "profile_image": {
          "small": "https://images.unsplash.com/profile-1449546653256-0faea3006d34?ixlib=rb-0.3.5&q=80&fm=jpg&crop=faces&fit=crop&h=32&w=32",
          "medium": "https://images.unsplash.com/profile-1449546653256-0faea3006d34?ixlib=rb-0.3.5&q=80&fm=jpg&crop=faces&fit=crop&h=64&w=64",
          "large": "https://images.unsplash.com/profile-1449546653256-0faea3006d34?ixlib=rb-0.3.5&q=80&fm=jpg&crop=faces&fit=crop&h=128&w=128"
        },
        "links": {
          "self": "https://api.unsplash.com/users/lionsdenpro",
          "html": "https://unsplash.com/lionsdenpro",
          "photos": "https://api.unsplash.com/users/lionsdenpro/photos"
        }
      },
      "urls": {
        "raw": "https://images.unsplash.com/photo-1449614115178-cb924f730780",
        "full": "https://images.unsplash.com/photo-1449614115178-cb924f730780?ixlib=rb-0.3.5&q=80&fm=jpg&crop=entropy",
        "regular": "https://images.unsplash.com/photo-1449614115178-cb924f730780?ixlib=rb-0.3.5&q=80&fm=jpg&crop=entropy&w=1080&fit=max",
        "small": "https://images.unsplash.com/photo-1449614115178-cb924f730780?ixlib=rb-0.3.5&q=80&fm=jpg&crop=entropy&w=400&fit=max",
        "thumb": "https://images.unsplash.com/photo-1449614115178-cb924f730780?ixlib=rb-0.3.5&q=80&fm=jpg&crop=entropy&w=200&fit=max"
      },
      "links": {
        "self": "https://api.unsplash.com/photos/C-mxLOk6ANs",
        "html": "https://unsplash.com/photos/C-mxLOk6ANs",
        "download": "https://unsplash.com/photos/C-mxLOk6ANs/download"
      }
    },
    "user": {
      "id": "IFcEhJqem0Q",
      "updated_at": "2016-07-10T11:00:01-05:00",
      "username": "fableandfolk",
      "name": "Annie Spratt",
      "portfolio_url": "http://mammasaurus.co.uk",
      "bio": "Follow me on Twitter &amp; Instagram @anniespratt\r\nEmail me at hello@fableandfolk.com",
      "location": "New Forest National Park, UK",
      "total_collections": 36,
      "profile_image": {
        "small": "https://images.unsplash.com/profile-1450003783594-db47c765cea3?ixlib=rb-0.3.5&q=80&fm=jpg&crop=faces&fit=crop&h=32&w=32",
        "medium": "https://images.unsplash.com/profile-1450003783594-db47c765cea3?ixlib=rb-0.3.5&q=80&fm=jpg&crop=faces&fit=crop&h=64&w=64",
        "large": "https://images.unsplash.com/profile-1450003783594-db47c765cea3?ixlib=rb-0.3.5&q=80&fm=jpg&crop=faces&fit=crop&h=128&w=128"
      },
      "links": {
        "self": "https://api.unsplash.com/users/fableandfolk",
        "html": "https://unsplash.com/fableandfolk",
        "photos": "https://api.unsplash.com/users/fableandfolk/photos"
      }
    },
    "links": {
      "self": "https://api.unsplash.com/collections/296",
      "html": "https://unsplash.com/collections/296",
      "photos": "https://api.unsplash.com/collections/296/photos",
      "related": "https://api.unsplash.com/collections/296/related"
    }
  },
  // ... more Collections ...
]

```

--------------------------------

### Collection Response Example - Unsplash API

Source: https://unsplash.com/documentation

Example JSON response for a successful request to get a single collection.

```json
{
  "id": 206,
  "title": "Makers: Cat and Ben",
  "description": "Behind-the-scenes photos from the Makers interview with designers Cat Noone and Benedikt Lehnert.",
  "published_at": "2016-01-12T18:16:09-05:00",
  "last_collected_at": "2016-06-02T13:10:03-04:00",
  "updated_at": "2016-07-10T11:00:01-05:00",
  "featured": false,
  "total_photos": 12,
  "private": false,
  "share_key": "312d188df257b957f8b86d2ce20e4766",
  "cover_photo": null,
  "user": null,
  "links": {
    "self": "https://api.unsplash.com/collections/206",
    "html": "https://unsplash.com/collections/206/makers-cat-and-ben",
    "photos": "https://api.unsplash.com/collections/206/photos"
  }
}
```

--------------------------------

### Topic Object Example

Source: https://unsplash.com/documentation

A sample JSON object representing a topic, including its ID, slug, title, description, and timestamps.

```json
{
  "id": "bo8jQKTaE0Y",
  "slug": "wallpapers",
  "title": "Wallpapers",
  "description": "From epic drone shots to inspiring moments in nature, find free HD wallpapers worthy of your mobile and desktop screens. Finally.",
  "published_at": "2020-04-17T02:31:04Z",
  "updated_at": "2020-07-06T09:12:07-04:00",
  "starts_at": "2020-04-15T00:00:00Z"
}
```

--------------------------------

### Search Users Response Headers

Source: https://unsplash.com/documentation

Example response headers for a successful user search, including pagination and rate limit information.

```http
200 OK
Link: <https://api.unsplash.com/search/users?page=1&query=nas>; rel="first", <https://api.unsplash.com/search/users?page=1&query=nas>; rel="prev", <https://api.unsplash.com/search/users?page=3&query=nas>; rel="last", <https://api.unsplash.com/search/users?page=3&query=nas>; rel="next"
X-Ratelimit-Limit: 1000
X-Ratelimit-Remaining: 999

```

--------------------------------

### Updated Photo Object

Source: https://unsplash.com/documentation

Example of the JSON response body when a photo is successfully updated.

```json
{
  "id": "Dwu85P9SOIk",
  "created_at": "2016-05-03T11:00:28-04:00",
  "updated_at": "2016-07-10T11:00:01-05:00",
  "width": 2448,
  "height": 3264,
  "color": "#6E633A",
  "blur_hash": "LFC$yHwc8^$yIAS$%M%00KxukYIp",
  "downloads": 1345,
  "public_domain": false,
  "description": "A man drinking a coffee.",
  "exif": {
    "make": "Canon",
    "model": "Canon EOS 40D",
    "name": "Canon, EOS 40D",
    "exposure_time": "0.011111111111111112",
    "aperture": "4.970854",
    "focal_length": "37",
    "iso": 100
  },
  "location": {
    "city": "Montreal",
    "country": "Canada",
    "position": {
      "latitude": 45.473298,
      "longitude": -73.638488
    }
  },
  "tags": [
    { "title": "man" },
    { "title": "drinking" },
    { "title": "coffee" }
  ],
  "current_user_collections": [
    {
      "id": 206,
      "title": "Makers: Cat and Ben",
      "published_at": "2016-01-12T18:16:09-05:00",
      "last_collected_at": "2016-06-02T13:10:03-04:00",
      "updated_at": "2016-07-10T11:00:01-05:00",
      "cover_photo": null,
      "user": null
    }
  ],
  "urls": {
    "raw": "https://images.unsplash.com/photo-1417325384643-aac51acc9e5d",
    "full": "https://images.unsplash.com/photo-1417325384643-aac51acc9e5d?q=75&fm=jpg",
    "regular": "https://images.unsplash.com/photo-1417325384643-aac51acc9e5d?q=75&fm=jpg&w=1080&fit=max",
    "small": "https://images.unsplash.com/photo-1417325384643-aac51acc9e5d?q=75&fm=jpg&w=400&fit=max",
    "thumb": "https://images.unsplash.com/photo-1417325384643-aac51acc9e5d?q=75&fm=jpg&w=200&fit=max"
  },
  "links": {
    "self": "https://api.unsplash.com/photos/Dwu85P9SOIk",
    "html": "https://unsplash.com/photos/Dwu85P9SOIk",
    "download": "https://unsplash.com/photos/Dwu85P9SOIk/download",
    "download_location": "https://api.unsplash.com/photos/Dwu85P9SOIk/download"
  },
  "user": {
    "id": "QPxL2MGqfrw",
    "updated_at": "2016-07-10T11:00:01-05:00",
    "username": "exampleuser",
    "name": "Joe Example",
    "portfolio_url": "https://example.com/",
    "bio": "Just an everyday Joe",
    "location": "Montreal",
    "total_collections": 13,
    "links": {
      "self": "https://api.unsplash.com/users/exampleuser",
      "html": "https://unsplash.com/exampleuser",
      "photos": "https://api.unsplash.com/users/exampleuser/photos"
    }
  }
}
```

--------------------------------

### List All Topics

Source: https://unsplash.com/documentation

Use this endpoint to get a single page from the list of all topics. Parameters can be used to filter and sort the results.

```HTTP
GET /topics
```

--------------------------------

### Successful Response Headers

Source: https://unsplash.com/documentation

Example of successful HTTP response headers when retrieving user statistics. Includes rate limit information.

```HTTP
200 OK
X-Ratelimit-Limit: 1000
X-Ratelimit-Remaining: 999
```

--------------------------------

### Rate Limiting Headers Example

Source: https://unsplash.com/documentation

These headers indicate your current API request limit and the number of requests remaining within that limit.

```http
X-Ratelimit-Limit: 1000
X-Ratelimit-Remaining: 999

```

--------------------------------

### Fetch Photos with Count Parameter

Source: https://unsplash.com/documentation

This example demonstrates how to fetch a list of photos using the 'count' parameter. The response includes detailed information about each photo, its EXIF data, location, associated collections, URLs, and user details.

```json
[
  {
    "id": "Dwu85P9SOIk",
    "created_at": "2016-05-03T11:00:28-04:00",
    "updated_at": "2016-07-10T11:00:01-05:00",
    "width": 2448,
    "height": 3264,
    "color": "#6E633A",
    "blur_hash": "LFC$yHwc8^$yIAS$%M%00KxukYIp",
    "downloads": 1345,
    "description": "A man drinking a coffee.",
    "exif": {
      "make": "Canon",
      "model": "Canon EOS 40D",
      "exposure_time": "0.011111111111111112",
      "aperture": "4.970854",
      "focal_length": "37",
      "iso": 100
    },
    "location": {
      "name": "Montreal, Canada",
      "city": "Montreal",
      "country": "Canada",
      "position": {
        "latitude": 45.473298,
        "longitude": -73.638488
      }
    },
    "current_user_collections": [
      {
        "id": 206,
        "title": "Makers: Cat and Ben",
        "published_at": "2016-01-12T18:16:09-05:00",
        "last_collected_at": "2016-06-02T13:10:03-04:00",
        "updated_at": "2016-07-10T11:00:01-05:00",
        "cover_photo": null,
        "user": null
      },
      // ... more collections
    ],
    "urls": {
      "raw": "https://images.unsplash.com/photo-1417325384643-aac51acc9e5d",
      "full": "https://images.unsplash.com/photo-1417325384643-aac51acc9e5d?q=75&fm=jpg",
      "regular": "https://images.unsplash.com/photo-1417325384643-aac51acc9e5d?q=75&fm=jpg&w=1080&fit=max",
      "small": "https://images.unsplash.com/photo-1417325384643-aac51acc9e5d?q=75&fm=jpg&w=400&fit=max",
      "thumb": "https://images.unsplash.com/photo-1417325384643-aac51acc9e5d?q=75&fm=jpg&w=200&fit=max"
    },
    "links": {
      "self": "https://api.unsplash.com/photos/Dwu85P9SOIk",
      "html": "https://unsplash.com/photos/Dwu85P9SOIk",
      "download": "https://unsplash.com/photos/Dwu85P9SOIk/download",
      "download_location": "https://api.unsplash.com/photos/Dwu85P9SOIk/download"
    },
    "user": {
      "id": "QPxL2MGqfrw",
      "updated_at": "2016-07-10T11:00:01-05:00",
      "username": "exampleuser",
      "name": "Joe Example",
      "portfolio_url": "https://example.com/",
      "bio": "Just an everyday Joe",
      "location": "Montreal",
      "total_collections": 13,
      "instagram_username": "instantgrammer",
      "twitter_username": "crew",
      "links": {
        "self": "https://api.unsplash.com/users/exampleuser",
        "html": "https://unsplash.com/exampleuser",
        "photos": "https://api.unsplash.com/users/exampleuser/photos"
      }
    }
  },
  // ... more photos
]

```

--------------------------------

### Collection Photos Response Example - Unsplash API

Source: https://unsplash.com/documentation

Example JSON response for a successful request to get a collection's photos. Includes photo details, user information, and URLs.

```json
[
  {
    "id": "LBI7cgq3pbM",
    "created_at": "2016-05-03T11:00:28-04:00",
    "updated_at": "2016-07-10T11:00:01-05:00",
    "width": 5245,
    "height": 3497,
    "color": "#60544D",
    "blur_hash": "LoC%a7IoIVxZ_NM|M{s:%hRjWAo0",
    "description": "A man drinking a coffee.",
    "user": {
      "id": "pXhwzz1JtQU",
      "username": "poorkane",
      "name": "Gilbert Kane",
      "portfolio_url": "https://theylooklikeeggsorsomething.com/",
      "bio": "XO",
      "location": "Way out there",
      "total_collections": 52,
      "instagram_username": "instantgrammer",
      "twitter_username": "crew",
      "profile_image": {
        "small": "https://images.unsplash.com/face-springmorning.jpg?q=80&fm=jpg&crop=faces&fit=crop&h=32&w=32",
        "medium": "https://images.unsplash.com/face-springmorning.jpg?q=80&fm=jpg&crop=faces&fit=crop&h=64&w=64",
        "large": "https://images.unsplash.com/face-springmorning.jpg?q=80&fm=jpg&crop=faces&fit=crop&h=128&w=128"
      },
      "links": {
        "self": "https://api.unsplash.com/users/poorkane",
        "html": "https://unsplash.com/poorkane",
        "photos": "https://api.unsplash.com/users/poorkane/photos"
      }
    },
    "current_user_collections": [ 
      {
        "id": 206,
        "title": "Makers: Cat and Ben",
        "published_at": "2016-01-12T18:16:09-05:00",
        "last_collected_at": "2016-06-02T13:10:03-04:00",
        "updated_at": "2016-07-10T11:00:01-05:00",
        "cover_photo": null,
        "user": null
      },
      // ... more collections
    ],
    "urls": {
      "raw": "https://images.unsplash.com/face-springmorning.jpg",
      "full": "https://images.unsplash.com/face-springmorning.jpg?q=75&fm=jpg",
      "regular": "https://images.unsplash.com/face-springmorning.jpg?q=75&fm=jpg&w=1080&fit=max",
      "small": "https://images.unsplash.com/face-springmorning.jpg?q=75&fm=jpg&w=400&fit=max",
      "thumb": "https://images.unsplash.com/face-springmorning.jpg?q=75&fm=jpg&w=200&fit=max"
    },
    "links": {
      "self": "https://api.unsplash.com/photos/LBI7cgq3pbM",
      "html": "https://unsplash.com/photos/LBI7cgq3pbM",
      "download": "https://unsplash.com/photos/LBI7cgq3pbM/download",
      "download_location": "https://api.unsplash.com/photos/LBI7cgq3pbM/download"
    }
  },
  // ... more photos
]
```

--------------------------------

### Constructing a Custom Image URL

Source: https://unsplash.com/documentation

Demonstrates how to append Imgix parameters to a raw Unsplash image URL to create a custom-sized image. Ensure the 'ixid' parameter is preserved.

```javascript
photo.urls.raw + "&w=1500&dpr=2";
// => https://images.unsplash.com/photo-1461988320302-91bde64fc8e4?ixid=2yJhcHBfaWQiOjEyMDd9&w=1500&dpr=2
```

--------------------------------

### Unsplash API Error Response Example

Source: https://unsplash.com/documentation

An example of an error response from the Unsplash API, indicating issues with the provided data. Errors are returned in an 'errors' array.

```json
{
  "errors": ["Username is missing", "Password cannot be blank"]
}
```

--------------------------------

### Client Registration Response

Source: https://unsplash.com/documentation/dynamic-client-registration

The API returns a 201 Created status followed by the new client credentials.

```http
201 Created
```

```json
{
  "client_id": "a374a6d26de75ce50e3e2013",
  "client_secret": "6e1e31c781b31f27e6bb756c8579b33c",
  "client_id_issued_at": 1588259748,
  "client_secret_expires_at": 0,
  "client_name": "Beverly's Plugin instance",
  "description": "",
  "redirect_uris": [],
  "token_endpoint_auth_method": "client_secret_post",
  "grant_types": ["authorization_code", "refresh_token", "client_credentials", "password"],
  "response_types": ["code"],
  "scope": "public"
}
```

--------------------------------

### List Collections - GET Request

Source: https://unsplash.com/documentation

Use this endpoint to get a single page from the list of all collections. Optional parameters include 'page' for the page number and 'per_page' for the number of items per page.

```http
GET /collections
```

--------------------------------

### Constructing a Different Custom Image URL

Source: https://unsplash.com/documentation

Shows how to create another image variant by modifying the parameters on the raw URL, allowing for different dimensions without re-fetching.

```javascript
photo.urls.raw + "&w=750&dpr=2";
// => https://images.unsplash.com/photo-1461988320302-91bde64fc8e4?ixid=2yJhcHBfaWQiOjEyMDd9&w=750&dpr=2
```

--------------------------------

### Get Total Stats

Source: https://unsplash.com/documentation

Retrieves a list of counts for all Unsplash metrics.

```APIDOC
## GET /stats/total

### Description
Get a list of counts for all of Unsplash.

### Method
GET

### Endpoint
/stats/total

### Response
#### Success Response (200)
- **photos** (integer) - Total number of photos.
- **downloads** (integer) - Total number of downloads.
- **views** (integer) - Total number of views.
- **photographers** (integer) - Total number of photographers.
- **pixels** (integer) - Total number of pixels.
- **downloads_per_second** (number) - Average number of downloads per second for the past 7 days.
- **views_per_second** (number) - Average number of views per second for the past 7 days.
- **developers** (integer) - Total number of developers.
- **applications** (integer) - Total number of applications.
- **requests** (integer) - Total number of requests.

### Response Example
```json
{
  "photos": 10000,
  "downloads": 2000,
  "views": 5000,
  "photographers": 100,
  "pixels": 200000,
  "downloads_per_second": 10,
  "views_per_second": 20,
  "developers": 20,
  "applications": 50,
  "requests": 8000
}
```
```

--------------------------------

### Initiate Authorization

Source: https://unsplash.com/documentation/user-authentication-workflow

Direct users to this endpoint to begin the OAuth2 authorization process. Include your application's credentials and desired scopes.

```APIDOC
## GET /oauth/authorize

### Description
Initiates the OAuth2 authorization flow by directing the user to Unsplash.

### Endpoint
`https://unsplash.com/oauth/authorize`

### Query Parameters
- **client_id** (string) - Required - Your application's access key.
- **redirect_uri** (string) - Required - A URI you control that handles successful user authorization.
- **response_type** (string) - Required - Must be set to "code" for the authorization workflow.
- **scope** (string) - Optional - A `+`-separated list of requested scopes (e.g., `public+read_user`).
```

--------------------------------

### Get Monthly Stats

Source: https://unsplash.com/documentation

Retrieves the overall Unsplash stats for the past 30 days.

```APIDOC
## GET /stats/month

### Description
Get the overall Unsplash stats for the past 30 days.

### Method
GET

### Endpoint
/stats/month

### Response
#### Success Response (200)
- **downloads** (integer) - Total downloads in the past 30 days.
- **views** (integer) - Total views in the past 30 days.
- **new_photos** (integer) - Number of new photos in the past 30 days.
- **new_photographers** (integer) - Number of new photographers in the past 30 days.
- **new_pixels** (integer) - Number of new pixels in the past 30 days.
- **new_developers** (integer) - Number of new developers in the past 30 days.
- **new_applications** (integer) - Number of new applications in the past 30 days.
- **new_requests** (integer) - Number of new requests in the past 30 days.

### Response Example
```json
{
  "downloads": 20,
  "views": 200,
  "new_photos": 10,
  "new_photographers": 5,
  "new_pixels": 2000,
  "new_developers": 8,
  "new_applications": 5,
  "new_requests": 100
}
```
```

--------------------------------

### List Collections - 200 OK Response

Source: https://unsplash.com/documentation

Example of a successful response when listing collections. Includes pagination links and rate limit information.

```http
200 OK
Link: <https://api.unsplash.com/collections?page=8>; rel="last", <https://api.unsplash.com/collections?page=2>; rel="next"
X-Ratelimit-Limit: 1000
X-Ratelimit-Remaining: 999
```
Tokens:
Raw