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. { "query": "nature", "maxResults": 20 } ### 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. json [ { "id": "U-DgtDG6MRo", "description": "Tesla Model 3", "updatedAt": "2024-12-05T18:30:33Z", "urls": { "raw": "https://images.unsplash.com/photo-1585011664466-b7bbe92f34ef?ixid=M3wzNjc2NDl8MHwxfHNlYXJjaHwxfHxUZXNsYXxlbnwwfHx8fDE3MzM0NjcxMjd8MA&ixlib=rb-4.0.3", "full": "https://images.unsplash.com/photo-1585011664466-b7bbe92f34ef?crop=entropy&cs=srgb&fm=jpg&ixid=M3wzNjc2NDl8MHwxfHNlYXJjaHwxfHxUZXNsYXxlbnwwfHx8fDE3MzM0NjcxMjd8MA&ixlib=rb-4.0.3&q=85", "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", "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", "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" }, "user": { "username": "austin__ramsey", "name": "Austin Ramsey" }, "tags": [] }, ... ]