API Documentation

Everything you need to integrate SourceSplash into your project

Quick Start

The simplest way to use SourceSplash - just use the URL in an image tag:

<img src="https://api.sourcesplash.com/i/random" alt="Random" />

API Endpoints

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

Rate Limits

🆓

Free

100/hour

Per IP address

Pro

1,000/hour

Coming soon

🚀

Enterprise

Unlimited

Coming soon

Response Format

{
  "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"
}

Legal & Policies