Unsplash Image Scraper avatar

Unsplash Image Scraper

Pricing

from $2.00 / 1,000 image founds

Go to Apify Store
Unsplash Image Scraper

Unsplash Image Scraper

Collect free Unsplash photos from searches, collections, topics or photographers: image links, size, colour, likes and photographer details.

Pricing

from $2.00 / 1,000 image founds

Rating

0.0

(0)

Developer

Khadin Akbar

Khadin Akbar

Maintained by Community

Actor stats

0

Bookmarked

8

Total users

5

Monthly active users

5 days ago

Last modified

Features

Limited permissions

Share

What does Unsplash Image Scraper do?

Unsplash Image Scraper collects free Unsplash photos from search phrases, collections, topics, photographers or single photo links. Each row is one photo with five image links (original to thumbnail), size, shape, dominant colour, likes, topics and full photographer details: name, username, profile, bio, location, Instagram and website. Paid Unsplash+ photos are skipped and never charged. It is also usable through Apify MCP, and every run writes a plain-words agentSummary for AI agents.

What data do you get?

FieldWhat it is
id, photoUrlUnsplash photo ID and public page
imageUrlRaw, imageUrlFull, imageUrlRegular, imageUrlSmall, imageUrlThumbImage links from original to about 200 px
width, height, orientation, colorSize, shape and dominant colour
likes, topics, createdAt, updatedAtPopularity and dates
title, description, altDescriptionText about the photo
photographerName, photographerUsername, photographerProfileUrlWho took it
photographerBio, photographerLocation, photographerInstagram, photographerPortfolioUrl, photographerTotalPhotosPublic photographer details
source, rank, sourceUrl, scrapedAtWhere the row came from and when
license, licenseUrlUnsplash License context

tags is filled only when Unsplash supplies tags for that photo, so it is often empty.

How much does it cost?

You pay a tiny start fee plus one fee per saved photo. The Apify plan tier sets the photo price, from $0.0030 on the Free tier down to $0.0020 on Gold and above (about $2 per 1,000 photos at Gold). Apify platform usage is included in these prices. A row is charged only when it is complete and free to use: paid Unsplash+ photos and rows missing an image link or photographer are skipped. See the Pricing tab for the live numbers.

How to use it

  1. Add search phrases (for example mountain lake), Unsplash links, or both.
  2. Set the images per source and the total cap (1 to 1,000 per run; the free Apify plan is limited to 25 per run).
  3. Optional: orientation, dominant colour and sort order apply to search phrases.
  4. Run, then download the dataset as JSON, CSV or Excel.
  • Search page: https://unsplash.com/s/photos/blue-sky?orientation=landscape
  • Collection: https://unsplash.com/collections/1580860/wallpapers
  • Topic: https://unsplash.com/t/nature
  • Photographer: https://unsplash.com/@heftiba
  • Single photo: https://unsplash.com/photos/a-chair-sitting-next-to-a-plant-in-a-room-bYP89K7HX6c

Input example

{
"queries": ["minimal home office"],
"startUrls": ["https://unsplash.com/t/nature"],
"maxItemsPerQuery": 50,
"maxTotalItems": 100,
"orientation": "landscape"
}

Output example

{
"id": "bYP89K7HX6c",
"title": "a chair sitting next to a plant in a room",
"photoUrl": "https://unsplash.com/photos/a-chair-sitting-next-to-a-plant-in-a-room-bYP89K7HX6c",
"imageUrlRegular": "https://images.unsplash.com/photo-example?w=1080",
"width": 3957,
"height": 5935,
"orientation": "portrait",
"color": "#595940",
"likes": 300,
"photographerName": "Example Photographer",
"photographerUsername": "example",
"photographerProfileUrl": "https://unsplash.com/@example",
"photographerLocation": "Berlin, Germany",
"source": "minimal home office",
"rank": 1,
"scrapedAt": "2026-11-15T12:00:00.000Z",
"license": "Unsplash License",
"licenseUrl": "https://unsplash.com/license"
}

Run outcomes

Open the OUTPUT record in the run's key-value store. outcome is one of COMPLETE, PARTIAL (some sources failed or the spending limit stopped the run), VALID_EMPTY (nothing matched, nothing charged), INVALID_INPUT or UPSTREAM_FAILED (Unsplash could not be read, run marked failed, nothing charged). agentSummary states the result in one sentence.

Use with AI agents (MCP)

Use Actor khadinakbar/unsplash-image-scraper. Input: search phrases or Unsplash links, plus caps. Output: one row per free photo with image links and photographer attribution. Keep maxTotalItems small for a first call, then read OUTPUT.agentSummary.

Limits and good practice

  • Only public, free Unsplash photos. Unsplash+ (paid) photos are skipped.
  • Photographer pages with many paid photos need more pages to fill your cap, so they run slower.
  • The Actor reads image links; it does not download image files. Credit the photographer where the Unsplash License asks you to.
  • This Actor is not affiliated with Unsplash. Review the Unsplash License and terms before reuse.

FAQ

Why did I get fewer photos than my cap? The source ran out of free photos, or a paid-photo filter removed some. Nothing is charged for skipped photos.

Can I scrape a whole collection? Yes. Paste its link and set maxItemsPerQuery up to 500.

Is it legal? It reads public pages only. Rights to each photo are set by the Unsplash License; check it for your use.