# Unsplash Scraper: Photos, Views, Downloads & Photographers (`clearpath/unsplash-scraper`) Actor

Unsplash photos past the 4,000-result limit of one search, each with views, downloads and 30 days of daily statistics. Plus EXIF camera data, location, tags, topics and photographer profiles with their totals. Search by keyword, photographer, collection, topic, photo ID or link. No login.

- **URL**: https://apify.com/clearpath/unsplash-scraper.md
- **Developed by:** [ClearPath](https://apify.com/clearpath) (community)
- **Categories:** For creators, Marketing
- **Features:** Limited permissions
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.69 / 1,000 photos

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

[![Unsplash scraper past the 4,000-result limit: 7,328 photos from one pour over coffee search, each with views, downloads and 30-day statistics](https://api.apify.com/v2/key-value-stores/rfpznBPgVbyLYqNaQ/records/unsplash-scraper-readme-hero-depth-v1-ce001bccd586.jpg)](https://console.apify.com/actors/mPTJYXlHQLDsCu8mg/input)

From **Clearpath**, creators of [Adobe Stock Scraper](https://apify.com/clearpath/adobe-stock-scraper), [Reddit Search Scraper](https://apify.com/clearpath/reddit-search-scraper) and [Reddit Post Comments Scraper](https://apify.com/clearpath/reddit-post-comments-bulk-scraper). **265,000+ combined lifetime runs** across these content-research scrapers.

### Every photo an Unsplash search holds

**Past the 4,000-result limit.** Unsplash shows at most 4,000 results for one search. This actor keeps going: a recorded run saved **7,328 unique photos for the single search `pour over coffee`**, each one once, numbered in order. The most viewed photo in that run, with 58.5 million views, came after the first 4,000.

**Views and downloads, day by day.** Every free photo comes with its total views and downloads, plus its views and downloads for each of the last 30 days. Every photographer comes with total views and downloads, their own daily series for the last 30 days, interests, Unsplash+ status and badge when Unsplash awarded one. Use it to see which photos, subjects and photographers actually get used.

**Every way to pick photos, every detail.** Search terms with color, orientation, license and sort filters, a photographer's portfolio, a collection, a topic, photo IDs or any pasted unsplash.com link. Each photo carries camera settings (EXIF), location, tags, topics, five image sizes and full attribution.

<a href="https://console.apify.com/actors/mPTJYXlHQLDsCu8mg/input" data-demo-cta="true"><img src="https://api.apify.com/v2/key-value-stores/rfpznBPgVbyLYqNaQ/records/unsplash-scraper-readme-cta-depth-v1-f5110842e6d9.png" width="248" height="52" alt="Search Unsplash photos" /></a>

### Quick input

Try 100 coffee photos with their views, downloads and 30-day statistics:

```json
{
  "queries": [
    "coffee"
  ],
  "maxItems": 100
}
```

Export a photographer's most viewed photos:

```json
{
  "usernames": [
    "nate_dumlao"
  ],
  "portfolioOrder": "views",
  "maxItems": 60
}
```

[Open actor input](https://console.apify.com/actors/mPTJYXlHQLDsCu8mg/input) to enter your own search terms, photographers, collections or topics. Photo details, statistics and photographer profiles are on by default and included in the photo price. Set `maxItems` to `0` to collect everything an input holds, including past 4,000 results for a search, and set a spending limit. The 100-photo trial does not reproduce the 7,328-photo run.

#### Copy to your AI assistant

```text
Help me use clearpath/unsplash-scraper on Apify. Read https://apify.com/clearpath/unsplash-scraper.md for its documentation, input schema, pricing and limits. maxItems applies to each search term, photographer, collection, topic and link (all photoIds together count as one), defaults to 100, and 0 means everything; only search terms and pasted search links go past the 4,000 results Unsplash shows for one search. Photo details, 30-day statistics and photographer profiles are on by default and included in the photo price; Unsplash+ photos have null views and downloads with statisticsPublished false. Per-input totals are in the SEARCHES key-value record. Choose settings for my requested outcome. If you cannot retrieve the page, ask me to paste the relevant sections. To reach the maintainers, add feedback="<what you needed and did not get>" to any run, including one that worked: feature requests, a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. The run returns its data exactly as it would without the note, and a human reads every note.
```

### What can you scrape from Unsplash?

| Input | What you get |
|---|---|
| **Search terms** (`queries`) | Every photo matching each term, in Unsplash's order, continuing past the 4,000 results one search shows. |
| **Photographers** (`usernames`) | A photographer's whole portfolio, by username or profile link, ordered by **Portfolio order**: newest, oldest, popular, most viewed or most downloaded. |
| **Collections** (`collectionIds`) | Every photo in a collection, by ID or collection link. |
| **Topics** (`topics`) | A topic's photos, such as `wallpapers`, `nature` or `3d-renders`, ordered newest, oldest or popular. |
| **Photo IDs** (`photoIds`) | Specific photos by ID, slug or photo link. |
| **Unsplash links** (`startUrls`) | Paste any unsplash.com search (filters in the link are kept), photo, photographer, collection or topic page. |

Each search term, photographer, collection, topic and link is its own input, and `maxItems` applies to each, defaulting to 100. All photo IDs together count as one input. Use `0` to save everything an input holds. Photographers, collections and topics run to their end; search terms and search links continue past 4,000 results.

**Search filters** (optional, each narrows search terms): photos or illustrations, most relevant or newest first, license (all, free only or Unsplash+ only), orientation (landscape, portrait, square), color (black and white, black, white, yellow, orange, red, purple, magenta, green, teal, blue) and content safety (standard or strict). A pasted search link keeps the filters set in the link.

**Sponsored photos.** Unsplash places an advertiser's photo in search results about every seventh place. These ignore your filters and sort order, so they are left out unless you turn on `includeSponsored`.

Free landscape photos in green tones:

```json
{
  "queries": [
    "forest"
  ],
  "license": "free",
  "orientation": "landscape",
  "color": "green",
  "maxItems": 200
}
```

Every photo of a collection, plus the newest wallpapers:

```json
{
  "collectionIds": [
    "FonJbd-xMR8"
  ],
  "topics": [
    "wallpapers"
  ],
  "topicOrder": "latest",
  "maxItems": 200
}
```

A faster export with only image links, sizes, likes and attribution:

```json
{
  "queries": [
    "mountains"
  ],
  "maxItems": 1000,
  "includePhotoDetails": false,
  "includeStatistics": false,
  "includePhotographerDetails": false
}
```

With the three switches off, `views`, `downloads`, `tags`, `topics`, `camera`, `location` and the daily series are `null`, and the photographer's badge, interests and statistics are left out. The price per photo is the same either way.

### Unsplash views and downloads for photos and photographers

With the default settings every free photo carries:

- `views` and `downloads`: totals since upload
- `viewsLast30Days` and `downloadsLast30Days`: totals for the last 30 days
- `dailyViews` and `dailyDownloads`: one entry per day for the last 30 days, each with its date

Every photographer carries `totalViews`, `totalDownloads`, `viewsLast30Days`, `downloadsLast30Days`, `averageDailyViews`, `averageDailyDownloads` and their own `dailyViews` and `dailyDownloads`, plus `badge` when Unsplash awarded one (for example "1 billion+ views"), `interests`, `topTags`, portfolio counts and Unsplash+ status. A photographer's profile is fetched once per run, however many of their photos are saved.

Unsplash does not publish view and download counts for Unsplash+ photos. Those rows carry `null` instead of a misleading zero, with `statisticsPublished` set to `false`. A real Unsplash+ row (excerpt):

```json
{
  "id": "W9KNSN6VN1s",
  "url": "https://unsplash.com/photos/3d-illustration-molecules-atoms-bacgkround-medical-background-for-banner-or-flyer-molecular-structure-at-the-atomic-level-W9KNSN6VN1s",
  "isPlus": true,
  "isPremium": true,
  "isFree": false,
  "license": "Unsplash+ License",
  "likes": 93,
  "views": null,
  "downloads": null,
  "statisticsPublished": false,
  "viewsLast30Days": null,
  "downloadsLast30Days": null,
  "dailyViews": null,
  "dailyDownloads": null
}
```

**Follow statistics over time.** Each run returns the 30 days before it. Schedule the same input monthly for a continuous daily history, or weekly to watch new uploads, and compare runs by photo `id`.

### What data do you get from Unsplash?

- **Photo**: ID, slug, page link, title, description, alt text, upload, update and featured dates, width, height, orientation, aspect ratio, dominant color, blur hash, likes
- **Statistics**: total views and downloads, 30-day totals, daily views and downloads for the last 30 days
- **Details**: tags, topics with submission status, camera make, model, exposure, aperture, focal length and ISO, location with city, country and coordinates, slugs in 9 languages
- **License**: Unsplash+ and free flags, license name, public domain flag, sponsored flag with the sponsor's name and links
- **Image links**: raw, full, regular, small and thumb sizes, download link and the link Unsplash counts a download with
- **Photographer**: name, username, bio, location, website, Instagram and X (Twitter) usernames, profile images, for-hire flag, badge, interests, top tags, portfolio counts, total and 30-day views and downloads with daily series
- **Search context**: which input returned the photo, its link, and its position within that input

A real photo row from a `chemex` search (the four daily series shortened to 3 of 30 days, `topTags` to 8 of 30):

```json
{
  "id": "zX2MRhcvqNo",
  "slug": "clear-glass-jar-with-brown-liquid-zX2MRhcvqNo",
  "url": "https://unsplash.com/photos/clear-glass-jar-with-brown-liquid-zX2MRhcvqNo",
  "assetType": "photo",
  "assetTypeLabel": "Photo",
  "isPlus": false,
  "isPremium": false,
  "isFree": true,
  "license": "Unsplash License",
  "title": "Coffee at home #4",
  "description": "Coffee at home #4",
  "altDescription": "clear glass jar with brown liquid",
  "shortDescription": null,
  "seoDescription": null,
  "createdAt": "2020-07-29T10:36:49Z",
  "updatedAt": "2026-11-03T07:10:34Z",
  "featuredAt": null,
  "isFeatured": false,
  "width": 4573,
  "height": 3658,
  "orientation": "landscape",
  "aspectRatio": 1.2501,
  "color": "#a6a6a6",
  "blurHash": "L9Gk^0%N4o={AI~VDitSyX%MWBWY",
  "likes": 12,
  "views": 55404,
  "downloads": 393,
  "statisticsPublished": true,
  "viewsLast30Days": 475,
  "downloadsLast30Days": 2,
  "dailyViews": [
    {
      "date": "2026-10-04",
      "views": 7
    },
    {
      "date": "2026-10-05",
      "views": 15
    },
    {
      "date": "2026-10-06",
      "views": 13
    }
  ],
  "dailyDownloads": [
    {
      "date": "2026-10-04",
      "downloads": 0
    },
    {
      "date": "2026-10-05",
      "downloads": 0
    },
    {
      "date": "2026-10-06",
      "downloads": 0
    }
  ],
  "imageUrls": {
    "raw": "https://images.unsplash.com/photo-1596018589751-57ce7f7e7c49?ixid=NHwxMjA3fDA&ixlib=rb-4.1.0",
    "full": "https://images.unsplash.com/photo-1596018589751-57ce7f7e7c49?crop=entropy&cs=srgb&fm=jpg&ixid=NHwxMjA3fDA&ixlib=rb-4.1.0&q=85",
    "regular": "https://images.unsplash.com/photo-1596018589751-57ce7f7e7c49?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=NHwxMjA3fDA&ixlib=rb-4.1.0&q=80&w=1080",
    "small": "https://images.unsplash.com/photo-1596018589751-57ce7f7e7c49?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=NHwxMjA3fDA&ixlib=rb-4.1.0&q=80&w=400",
    "thumb": "https://images.unsplash.com/photo-1596018589751-57ce7f7e7c49?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=NHwxMjA3fDA&ixlib=rb-4.1.0&q=80&w=200",
    "smallS3": "https://s3.us-west-2.amazonaws.com/images.unsplash.com/small/photo-1596018589751-57ce7f7e7c49"
  },
  "downloadUrl": "https://unsplash.com/photos/zX2MRhcvqNo/download?ixid=NHwxMjA3fDA",
  "downloadTrackingUrl": "https://api.unsplash.com/photos/zX2MRhcvqNo/download?ixid=NHwxMjA3fDA",
  "tags": [
    "coffee",
    "cold brew",
    "coffee at home",
    "chemex",
    "food",
    "plant",
    "furniture",
    "pottery",
    "deutschland",
    "saucer"
  ],
  "topics": [
    {
      "id": "xjPR4hlkBGA",
      "slug": "food-drink",
      "title": "Food & Drink",
      "visibility": "hidden"
    }
  ],
  "topicSubmissions": [
    {
      "topic": "food-drink",
      "status": "approved",
      "approvedAt": "2020-07-31T07:00:08Z"
    }
  ],
  "camera": {
    "make": "FUJIFILM",
    "model": "X-T2",
    "name": "FUJIFILM, X-T2",
    "exposureTime": "1/500",
    "aperture": "2.8",
    "focalLength": "56.0",
    "iso": 200
  },
  "location": {
    "name": "Oldenburg, Deutschland",
    "city": "Oldenburg",
    "country": "Deutschland",
    "latitude": 53.14345,
    "longitude": 8.214552
  },
  "isPublicDomain": false,
  "isIndexed": true,
  "isSponsored": false,
  "sponsorship": null,
  "breadcrumbs": [],
  "alternativeSlugs": {
    "en": "clear-glass-jar-with-brown-liquid-zX2MRhcvqNo",
    "es": "frasco-de-vidrio-transparente-con-liquido-marron-zX2MRhcvqNo",
    "ja": "茶色の液体が入った透明なガラス瓶-zX2MRhcvqNo",
    "fr": "bocal-en-verre-transparent-avec-liquide-brun-zX2MRhcvqNo",
    "it": "barattolo-di-vetro-trasparente-con-liquido-marrone-zX2MRhcvqNo",
    "ko": "갈색-액체를-가진-명확한-유리제-단지-zX2MRhcvqNo",
    "de": "klarglasgefass-mit-brauner-flussigkeit-zX2MRhcvqNo",
    "pt": "frasco-de-vidro-transparente-com-liquido-marrom-zX2MRhcvqNo",
    "id": "toples-kaca-bening-dengan-cairan-coklat-zX2MRhcvqNo"
  },
  "isPinnedByPhotographer": null,
  "photographer": {
    "id": "DNBd_KtS2po",
    "username": "andreasbehr",
    "name": "Andreas Behr",
    "firstName": "Andreas",
    "lastName": "Behr",
    "profileUrl": "https://unsplash.com/@andreasbehr",
    "bio": "More coffee related pictures at \r\nhttps://www.instagram.com/wahrebohne",
    "location": "Germany",
    "portfolioUrl": null,
    "instagramUsername": "wahrebohne",
    "twitterUsername": null,
    "paypalEmail": null,
    "profileImageUrl": "https://images.unsplash.com/profile-1595917505545-04000c4c6a9eimage?ixlib=rb-4.1.0&crop=faces&fit=crop&w=128&h=128",
    "profileImageUrls": {
      "small": "https://images.unsplash.com/profile-1595917505545-04000c4c6a9eimage?ixlib=rb-4.1.0&crop=faces&fit=crop&w=32&h=32",
      "medium": "https://images.unsplash.com/profile-1595917505545-04000c4c6a9eimage?ixlib=rb-4.1.0&crop=faces&fit=crop&w=64&h=64",
      "large": "https://images.unsplash.com/profile-1595917505545-04000c4c6a9eimage?ixlib=rb-4.1.0&crop=faces&fit=crop&w=128&h=128"
    },
    "forHire": true,
    "acceptedTerms": true,
    "totalPhotos": 17,
    "totalFreePhotos": 17,
    "totalFeaturedPhotos": 7,
    "totalIllustrations": 0,
    "totalFreeIllustrations": 0,
    "totalFeaturedIllustrations": 0,
    "totalLikes": 0,
    "totalCollections": 2,
    "updatedAt": "2026-07-10T14:03:54Z",
    "numericId": 5061667,
    "badge": null,
    "badgeSlug": null,
    "isPlusContributor": false,
    "isPlusPhotographer": false,
    "isPlusIllustrator": false,
    "allowsMessages": true,
    "isIndexed": true,
    "interests": [
      "coffee",
      "Coffee Shop"
    ],
    "topTags": [
      "alcohol",
      "army",
      "art",
      "blossom",
      "cafe",
      "camera",
      "coffee",
      "coffee cup"
    ],
    "featuredPhotoIds": [
      "CIIpqDYnj4s",
      "b9zaa7_1GC8",
      "Lc2-wQ4_15w"
    ],
    "totalDownloads": 31675,
    "totalViews": 4797369,
    "downloadsLast30Days": 235,
    "viewsLast30Days": 27767,
    "averageDailyDownloads": 8,
    "averageDailyViews": 926,
    "dailyDownloads": [
      {
        "date": "2026-10-04",
        "downloads": 5
      },
      {
        "date": "2026-10-05",
        "downloads": 5
      },
      {
        "date": "2026-10-06",
        "downloads": 10
      }
    ],
    "dailyViews": [
      {
        "date": "2026-10-04",
        "views": 1463
      },
      {
        "date": "2026-10-05",
        "views": 2196
      },
      {
        "date": "2026-10-06",
        "views": 1281
      }
    ]
  },
  "search": {
    "type": "query",
    "value": "chemex",
    "label": "'chemex'",
    "url": "https://unsplash.com/s/photos/chemex",
    "inputIndex": 0
  },
  "position": 264,
  "scrapedAt": "2026-11-03T11:57:08Z"
}
```

Fields Unsplash leaves empty for a photo stay `null`, for example the location or camera of many photos. A sponsored photo, saved only with `includeSponsored` on, carries the sponsor (excerpt):

```json
{
  "id": "Kx3o6_m1Yv8",
  "url": "https://unsplash.com/photos/man-buying-item-in-shop-Kx3o6_m1Yv8",
  "isSponsored": true,
  "sponsorship": {
    "tagline": "Payments made easy",
    "taglineUrl": "https://squareup.com/us/en",
    "sponsorName": "Square",
    "sponsorUsername": "squareinc",
    "sponsorUrl": "https://unsplash.com/@squareinc"
  }
}
```

Every run also writes a `SEARCHES` record to its key-value store, one entry per input, with Unsplash's own count of matching photos (`totalResults`), how many were saved and whether the input ran to its end. Unsplash's count is an estimate and can be lower than what a run saves:

```json
[
  {
    "search": {
      "type": "query",
      "value": "pour over coffee",
      "label": "'pour over coffee'",
      "url": "https://unsplash.com/s/photos/pour-over-coffee",
      "inputIndex": 0
    },
    "totalResults": 5188,
    "saved": 7328,
    "complete": true
  }
]
```

CSV and Excel exports flatten nested fields into columns such as `photographer/name`; the default export keeps them nested.

### Integrations and scheduling

Run the Unsplash scraper on a [schedule](https://docs.apify.com/platform/schedules) in Apify Console: monthly to keep a continuous history of photo and photographer statistics, weekly to collect new uploads for a search or topic. Each completed run can trigger a webhook for n8n, Make or Zapier workflows; see [Apify integrations](https://docs.apify.com/platform/integrations).

### Pricing

You pay per photo saved: **$0.99 per 1,000 photos** on the Free plan. Bronze pays $0.89, Silver $0.79, Gold and above $0.69 per 1,000. Photo details, 30-day statistics and photographer profiles are included in that price.

| Charge | When | Price |
|---|---|---|
| Photo | Each photo saved | $0.99 per 1,000 on Free, $0.89 Bronze, $0.79 Silver, $0.69 Gold and above |
| Actor start | Once per run | $0.001 |
| Dataset result | Each row saved | $0.01 per 1,000 |

A 100-photo test costs about $0.10 on the Free plan. Inputs that find nothing add no photo charges. The Free plan has no extra limits.

### FAQ

**Do I need an Unsplash account or login?**
No. Enter a search term and run it. No Unsplash account, login, developer registration or key is involved.

**How do I see the views and downloads of an Unsplash photo?**
Search for it, paste its link into `startUrls` or put its ID in `photoIds`. Every free photo carries total views and downloads and its daily views and downloads for the last 30 days.

**How do I get statistics for an Unsplash photographer?**
Put the username or profile link in `usernames` and set `maxItems` to `0` for the whole portfolio. Each row carries the photographer's total views and downloads and their daily series; `portfolioOrder` set to `views` or `downloads` lists the best performers first.

**Can I get more than 4,000 results for one search?**
Yes, for search terms and pasted search links. Unsplash shows at most 4,000 results for one search; with `maxItems` above that (or `0`), the actor keeps collecting and saves each photo once. The first results follow Unsplash's order and the rest follow after them. A recorded `pour over coffee` run saved 7,328 unique photos.

**Why does `SEARCHES` show fewer photos available than were saved?**
`totalResults` is Unsplash's own count, which is an estimate. A `chemex` search reported 1,456 photos and the run saved 1,608 unique ones.

**Does it include Unsplash+ photos?**
Yes. Every row has `isPlus` and `license`. Set `license` to `free` or `plus` to keep only one kind. Unsplash publishes no views or downloads for Unsplash+ photos, so those fields are `null`.

**Can I use the filters from the Unsplash website?**
Yes. Set them on unsplash.com and paste the search link into `startUrls`. The actor follows that search with its filters.

**Can I download the image files in bulk?**
Rows carry links to five image sizes and the download link, ready for any download tool. The actor does not store the image files. Use of each photo is governed by its license on Unsplash.

**What happens with a photo ID or username that does not exist?**
The run finishes normally, saves everything else and names the IDs or usernames it could not find.

**How fresh is the data?**
Every run reads Unsplash live. Daily statistics cover the 30 days before the run.

### Support

Questions, missing fields or a search that did not work as expected: open an issue in the Issues tab or email max@mapa.slmail.me. Unsplash is a trademark of Unsplash Inc. This actor is independent and is not affiliated with or endorsed by Unsplash.

# Actor input Schema

## `queries` (type: `array`):

Keywords to search on Unsplash, one search per term. A search continues past the 4,000 results Unsplash shows for one search when <b>Maximum results per input</b> allows it.

## `maxItems` (type: `integer`):

How many photos to save for each search term, photographer, collection, topic or link. <code>0</code> saves everything Unsplash has for it. Photo IDs count as one input together. Each saved photo is one billed result.

## `startUrls` (type: `array`):

Paste unsplash.com pages: a search (<code>/s/photos/coffee?orientation=portrait</code>, filters in the link are kept), a photo, a photographer (<code>/@username</code>), a collection (<code>/collections/…</code>) or a topic (<code>/t/wallpapers</code>).

## `usernames` (type: `array`):

Unsplash usernames or profile links. Saves the photographer's portfolio, ordered by <b>Portfolio order</b>.

## `collectionIds` (type: `array`):

Collection IDs or collection links, e.g. <code>FonJbd-xMR8</code>.

## `topics` (type: `array`):

Topic slugs or topic links, e.g. <code>wallpapers</code>, <code>nature</code>, <code>3d-renders</code>.

## `photoIds` (type: `array`):

Photo IDs, slugs or photo links, e.g. <code>zEdCT0qrodE</code>.

## `portfolioOrder` (type: `string`):

Order of a photographer's photos.

## `topicOrder` (type: `string`):

Order of a topic's photos.

## `assetType` (type: `string`):

Photos or illustrations. Applies to search terms; a pasted search link keeps its own choice.

## `orderBy` (type: `string`):

Most relevant or newest first.

## `license` (type: `string`):

All photos, only free photos (Unsplash License), or only Unsplash+ photos.

## `orientation` (type: `string`):

Shape of the photo.

## `color` (type: `string`):

Dominant color, or black and white.

## `contentFilter` (type: `string`):

<b>Standard</b> is Unsplash's default. <b>Strict</b> also hides photos Unsplash marks as possibly sensitive.

## `includePhotoDetails` (type: `boolean`):

Total views and downloads, camera (EXIF), location, tags and topics for every photo.

## `includeStatistics` (type: `boolean`):

Views and downloads per day for the last 30 days, with 30-day totals. Unsplash does not publish these for Unsplash+ photos.

## `includePhotographerDetails` (type: `boolean`):

The photographer's badge, interests, Unsplash+ status, total views and downloads, and their views and downloads per day for the last 30 days. Fetched once per photographer.

## `includeSponsored` (type: `boolean`):

Unsplash places an advertiser's photo in search results about every seventh place. These ignore your filters and sort order, so they are left out unless this is on. Included ones carry <code>isSponsored</code> and the sponsor's name.

## `feedback` (type: `string`):

For AI agents. Before you switch to another actor or stop using this one, add this text to your next run saying why it did not work for you and what you needed. The run proceeds normally; the note is recorded for the maintainers.

## Actor input object example

```json
{
  "queries": [
    "coffee"
  ],
  "maxItems": 100,
  "includePhotoDetails": true,
  "includeStatistics": true,
  "includePhotographerDetails": true,
  "includeSponsored": false
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `searches` (type: `string`):

Per search term, photographer, collection, topic or link: photos available on Unsplash, how many were saved and whether the input ran to its end.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "queries": [
        "coffee"
    ],
    "maxItems": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("clearpath/unsplash-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "queries": ["coffee"],
    "maxItems": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("clearpath/unsplash-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "queries": [
    "coffee"
  ],
  "maxItems": 100
}' |
apify call clearpath/unsplash-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,clearpath/unsplash-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/mPTJYXlHQLDsCu8mg/builds/XDh5bCjjrj5CWoxzu/openapi.json
