Unsplash Image Scraper 🖼️

Powerful and efficient Actor for fetching high-quality images and their metadata from Unsplash, the internet's source of freely-usable images.

Features ✨

• 🔍 Search images by keyword or topic
• 📊 Customizable number of results
• 🖼️ Multiple image resolution options (raw, full, regular, small, thumb)
• 👤 Photographer attribution data
• 🏷️ Image tags and descriptions
• ⚡ Rate-limit friendly
• 💾 Structured JSON output

Use Cases 🎯

• Content creation and blogging
• Web development and design
• Social media marketing
• Market research and trend analysis
• Digital asset management
• App development

Output Data Structure 📋

For each image, you'll receive:

• Unique image ID
• Description
• Last update timestamp
• Multiple resolution URLs
• Photographer information
• Associated tags

Input Parameters ⚙️

Parameter	Type	Description
query	String	Search term for images
maxResults	Integer	Maximum number of images to fetch

Limitations ⚠️

• Respects Unsplash API rate limits
• Maximum 10 images per page
• Results depend on Unsplash's content availability

Cost & Usage 💰

This Actor is optimized for performance and cost-effectiveness. The actual running costs depend on:

• Number of images requested
• Frequency of runs
• Platform computation units used

Support 🤝

For issues, feature requests, or questions, please contact support.

Input Example

A full explanation of an input example in JSON.

1{
2    "query": "nature",
3    "maxResults": 20
4}

Output sample

The results will be wrapped into a dataset which you can always find in the Storage tab. Here's an excerpt from the data you'd get if you apply the input parameters above:

And here is the same data but in JSON. You can choose in which format to download your data: JSON, JSONL, Excel spreadsheet, HTML table, CSV, or XML.

1[
2	{
3		"id": "U-DgtDG6MRo",
4		"description": "Tesla Model 3",
5		"updatedAt": "2024-12-05T18:30:33Z",
6		"urls": {
7			"raw": "https://images.unsplash.com/photo-1585011664466-b7bbe92f34ef?ixid=M3wzNjc2NDl8MHwxfHNlYXJjaHwxfHxUZXNsYXxlbnwwfHx8fDE3MzM0NjcxMjd8MA&ixlib=rb-4.0.3",
8			"full": "https://images.unsplash.com/photo-1585011664466-b7bbe92f34ef?crop=entropy&cs=srgb&fm=jpg&ixid=M3wzNjc2NDl8MHwxfHNlYXJjaHwxfHxUZXNsYXxlbnwwfHx8fDE3MzM0NjcxMjd8MA&ixlib=rb-4.0.3&q=85",
9			"regular": "https://images.unsplash.com/photo-1585011664466-b7bbe92f34ef?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3wzNjc2NDl8MHwxfHNlYXJjaHwxfHxUZXNsYXxlbnwwfHx8fDE3MzM0NjcxMjd8MA&ixlib=rb-4.0.3&q=80&w=1080",
10			"small": "https://images.unsplash.com/photo-1585011664466-b7bbe92f34ef?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3wzNjc2NDl8MHwxfHNlYXJjaHwxfHxUZXNsYXxlbnwwfHx8fDE3MzM0NjcxMjd8MA&ixlib=rb-4.0.3&q=80&w=400",
11			"thumb": "https://images.unsplash.com/photo-1585011664466-b7bbe92f34ef?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3wzNjc2NDl8MHwxfHNlYXJjaHwxfHxUZXNsYXxlbnwwfHx8fDE3MzM0NjcxMjd8MA&ixlib=rb-4.0.3&q=80&w=200"
12		},
13		"user": {
14			"username": "austin__ramsey",
15			"name": "Austin Ramsey"
16		},
17		"tags": []
18	},
19    ...
20]