Skip to content
TakoAPI
Back to skills

unsplash

by brokenwatch24

Image & Video Generation
716Downloads reported by clawskills.sh
2Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Search, browse, and download high-quality free photos from Unsplash's library of millions of images.

Description

What This Skill Does

Provides access to Unsplash's photo library via their REST API. Supports searching by keyword, color, and orientation, fetching random photos, browsing collections, and retrieving full photo metadata with dynamic image URLs and blur hash placeholders.

Images are served directly from Unsplash's CDN and support dynamic resizing via URL parameters, so you never need to download and reprocess full-resolution files.

When to Use It

  • Finding a hero image for a blog post by keyword
  • Pulling a random nature photo for a daily wallpaper script
  • Searching black-and-white portrait photos for a design mockup
  • Browsing a curated Unsplash collection for editorial content
  • Getting photographer attribution details before publishing

Example Workflow

INPUT

User asks: Find 3 landscape photos of forests and return small preview URLs

AGENT
  1. 1

    Call /search/photos with query=forest, orientation=landscape, per_page=3

  2. 2

    Parse results array to extract photo IDs and urls.small fields

  3. 3

    Call /photos/:id/download for each result to comply with API guidelines

  4. 4

    Return preview URLs alongside photographer names and profile links

OUTPUT

3 forest landscape preview URLs with photographer attribution ready for display

Requirements

  • Unsplash developer account (free) at unsplash.com/developers
  • Unsplash Access Key obtained by registering an application in the developer dashboard

Installation

clawhub install brokenwatch24/unsplash

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links