Unsplash API
Unsplash REST API — access to over 3 million high-resolution royalty-free photos for search, download, and collection management, enabling agents to automatically find and use professional photography in content creation workflows.
Score Breakdown
⚙ Agent Friendliness
🔒 Security
GDPR compliant. TLS enforced. Client ID is semi-public (intended for client-side use). OAuth 2.0 for user-level operations with scopes. US data processing. No SOC2 documented.
⚡ Reliability
Best When
You need free, high-quality photography for content generation agents where attribution can be provided and download volume is moderate.
Avoid When
You need guaranteed commercial licensing for all images, custom photography, or icon/illustration assets — use Cloudinary, Pexels, or a paid stock service.
Use Cases
- • Agents automatically finding relevant hero images for AI-generated blog posts based on article topic and keywords
- • Content generation pipelines — agents selecting contextually appropriate photos for social media posts and marketing materials
- • Dynamic image selection — agents querying Unsplash for fresh images to populate content management systems and landing pages
- • Mood board creation — agents building visual inspiration collections for design teams from curated Unsplash searches
- • Presentation generation — agents illustrating AI-generated presentations with professional photography matched to slide content
Not For
- • Commercial product photos — Unsplash has restrictions on using photos for direct product replacement/endorsement
- • High-volume automated downloads — rate limits and attribution requirements make mass download workflows complex
- • Paid stock photography quality guarantee — Unsplash quality varies; use Shutterstock or Getty for curated commercial work
Interface
Authentication
Client ID (public) for search/read-only access. OAuth 2.0 for user actions (likes, collections). Public access key in Authorization: Client-ID header. Demo accounts get 50 req/hour; production apps get 5000 req/hour after approval.
Pricing
API is free with attribution requirement (link back to Unsplash and photographer). Production access requires application approval. Unsplash+ subscription for extended commercial use without standard attribution requirement.
Agent Metadata
Known Gotchas
- ⚠ Download tracking is required by API guidelines — agents must call the photo download endpoint when using photos
- ⚠ Attribution is mandatory — photo credit with link to Unsplash must be included wherever photos are used
- ⚠ Demo mode has 50 req/hour limit — apply for production access before building any real agent workflow
- ⚠ Production access requires manual app review — not instant; account for review time in project planning
- ⚠ Search results are contextual/curated — programmatic keyword searches may not always return expected results
Alternatives
Full Evaluation Report
Detailed scoring breakdown, competitive positioning, security analysis, and improvement recommendations for Unsplash API.
Scores are editorial opinions as of 2026-03-06.