📸 Unsplash’s API

Use the world’s most powerful photo engine.

Stephanie Liverani
Unsplash Blog
5 min readAug 23, 2018

--

Unsplash: Unlike Any Creative Platform

Unsplash is the fastest growing library of over 600k+ free, quality, high-definition, license-free photos in the world. Every photo on Unsplash is free for your community to use, for both personal and commercial use. No payment and no license subscriptions required.

🖥️ Trusted by the world’s best products teams and products for creators
👏 Contributed by 97k+ photographers and used by 50+ million creatives
8 billion+ photos served/month
⬇️ 42 million+ photo downloads/month
🔥 16 photos downloaded/second (double any other image platform, including Shutterstock and Getty)

Unsplash supporting 16 photo downloads per second across 101 countries and every continent.

The Unsplash Library

Quality of library and accessibility is what differentiates Unsplash to traditional stock photo sites that exist today.

Manual curation
Our Editorial team curates every photo distributed on Unsplash to ensure our library is updated with authentic, world-class, high-res, photography. No more cheesy, stock photos. We focus on quality, not quantity.

Accessibility
All photos are licensed under the Unsplash License, making them free for both personal and commercial uses. No need for payments or confusing licenses with expiration dates.

Content guaranteed safe for work
Unsplash photos are PG-13 and manually reviewed before being exposed on Unsplash or distributed through Unsplash’s API. Our API can also fetch custom collections of photos to further guarantee quality and security.

Photo exclusivity
Unsplash’s library is exclusive to Unsplash — meaning, no other stock photo site can host or distribute these photos on their sites. Partnering with Unsplash means you have access to unique, beautiful content.

Unsplash’s API

Unsplash’s API is the most powerful photo engine in the world. The launch of our free API has lead to 500+ partnerships and 2.9 billion photos seen every month — doubling the reach of Unsplash photography worldwide.

Not only is it fast and flexible, but the Unsplash API is completely free to use. We can handle any volume (we even run Unsplash.com and Unsplash for iOS on it), and the setup is super simple.

Trello adds beautiful full-width Unsplash photos to their boards as a way for their users to customize their workspaces.

Medium integrates the Unsplash API directly inside of their editor, allowing beautiful imagery to be easily inserted inside of impactful writing.

With Adobe Spark, you can easily combine beautiful images from Unsplash photographers that make your graphics stand out on social.

Google Slides integrates Unsplash into their image selection, making it easy to create and present beautiful presentations for free.

To help sellers make their emails more visual, Square integrates Unsplash photography inside of their email and social media campaigns.

Paste by FiftyThree integrates the Unsplash library directly into their beautiful collaboration platform to help their users present ideas.

With their powerful Craft suite for Photoshop and Sketch, Invision allows designers to quickly pull in Unsplash images into any design or mockup.

Typeform integrates Unsplash photos into their form builder making it incredibly easy for their users to liven up their surveys.

To make launching products more visual, Product Hunt integrates Unsplash photography inside of their Ship landing pages.

To make adding images into prototypes and code examples, Codepen integrates the Unsplash library, making finding and adding an image super easy.

Semplice integrates Unsplash into their website builder, making it easy for designers to create beautiful online portfolios without writing any code.

Ghost was able to give its creators access to hundreds of thousands of high quality photos for use in their blogs.

API Technical Details:

  • JSON API (i.e. all requests to api.unsplash.com):
  • Built on Ruby on Rails
  • Currently handles 1 billion+ requests and 8.12 billion image requests over the last 30 days
  • Same API we run unsplash.com and Unsplash for iOS with
  • 99.998% up-time measured over the last 30 days
  • Hosted on AWS with high-availability Postgres and Redis stores. Elasticsearch backs the search and is distributed and fault-tolerant
  • Fronted by a distributed HTTP cache via Fastly. The Fastly HTTP cache is most effective when used with non-oauth authorized requests. This means that the responses aren’t customized to a ‘logged in’ user, which is the way the majority of our API partners use the API.
  • Automatic status monitoring and reporting with a dev-ops team on-call

--

--

Stephanie Liverani
Unsplash Blog

Cofounder/head of community/head of partnerships at Unsplash.