Documentation

Integrate in one line.

Everything you need to integrate SourceSplash into your project — REST in, image out.

01 — Quick start

The simplest possible start.

Just use the URL in an image tag — no key, no SDK:

index.html
<img src="https://api.sourcesplash.com/i/random" alt="Random" />
02 — Endpoints

The full surface.

GET/api/random

Get a random image with metadata

q(optional) Search query
w(optional) Width in pixels
h(optional) Height in pixels

GET/api/search

Search for images

q(required) Search query
page(optional) Page number

GET/i/random

Direct image URL (perfect for <img> tags)

Rotates every 3 minutes (20 different images per hour)

GET/i/{width}x{height}/placeholder

Generate grey placeholder images for mockups and development

https://api.sourcesplash.com/i/800x600/placeholder
https://api.sourcesplash.com/i/1920x1080/placeholder

Perfect for wireframes and testing — dimensions shown on image

03 — Rate limits

Generous by default.

Free

1,000/hour

With a free API key

Pro

20,000/hour

$9 / month

Enterprise

Unlimited

Contact us

04 — Response

Clean, predictable JSON.

200 OK · application/json
{
  "id": "pexels-123456",
  "url": "https://images.pexels.com/photos/...",
  "thumbnail": "https://images.pexels.com/photos/...",
  "width": 1920,
  "height": 1080,
  "author": "Photographer Name",
  "author_url": "https://www.pexels.com/@photographer",
  "source": "pexels",
  "description": "Image description"
}