Unsplash Scraper

Extract high-resolution photo URLs, photographer credits, download counts, and tag metadata from Unsplash free stock photos. Built on spider-browser .

Get started Docs

target
unsplash.com: success rate
99.9%: latency
~4ms

POST /fetch/unsplash.com/

return_format

curl -X POST https://api.spider.cloud/fetch/unsplash.com/ \
  -H "Authorization: Bearer $SPIDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"return_format": "json"}'

200 OK · cache hit · response shape

{
  "url": "https://unsplash.com/",
  "status": 200,
  "data": {
    "photo_url": "string",
    "photographer": "string",
    "likes": "string",
    "downloads": "string",
    "tags": "string",
    "description": "string",
    "resolution": "string",
    "license": "string"
  }
}

# Unsplash Scraper

**Photo URL**: string
**Photographer**: string
**Likes**: string
**Downloads**: string
**Tags**: string
**Description**: string
**Resolution**: string
**License**: string

Quick start

Extract data in minutes.

Structured JSON from unsplash.com with a single POST. AI-resolved selectors, cached on the first call.

unsplash-scraper.ts

import { SpiderBrowser } from "spider-browser";

const spider = new SpiderBrowser({
  apiKey: process.env.SPIDER_API_KEY!,
});

await spider.connect();
const page = spider.page!;
await page.goto("https://unsplash.com/s/photos/nature");
await page.content();

const data = await page.evaluate(`(() => {
  const photos = [];
  document.querySelectorAll("[data-testid='photo-grid-masonry'] figure").forEach(el => {
    const img = el.querySelector("img[srcset]");
    const src = img?.getAttribute("src");
    const alt = img?.getAttribute("alt");
    const photographer = el.querySelector("a[rel='nofollow']")?.textContent?.trim();
    if (src) photos.push({ src, alt, photographer });
  });
  return JSON.stringify({ total: photos.length, photos: photos.slice(0, 10) });
})()`);

console.log(JSON.parse(data));
await spider.close();

curl -X POST https://api.spider.cloud/fetch/unsplash.com/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"return_format": "json"}'

import requests

resp = requests.post(
    "https://api.spider.cloud/fetch/unsplash.com/",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={"return_format": "json"},
)
print(resp.json())

const resp = await fetch("https://api.spider.cloud/fetch/unsplash.com/", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ return_format: "json" }),
});
const data = await resp.json();
console.log(data);