📸 500px Image Scraper

Extract high-quality images from 500px.com, the premier photography community. Get image metadata including titles, descriptions, multiple sizes, and direct links to photographer pages with automatic pagination support.

---

✨ Why Use 500px Image Scraper?

• ⚡ Fast & Efficient - Direct GraphQL API access delivers results in seconds
• 🎯 Reliable Data - Extracts complete metadata including multiple image sizes
• 📈 Scalable - Scrape from 1 to 1000 images with automatic pagination (100 per page)
• 🎨 High Quality - Access both small (600px) and large (2048px) image versions
• 📊 Clean Output - Structured JSON data ready for analysis, galleries, or integration

---

📥 Input Parameters

Parameter	Type	Required	Default	Description
searchQuery	String	❌ No	"landscape photography"	Search term to find images (e.g., "landscape photography", "wildlife", "portrait")
sort	String	❌ No	relevance	Sort order: relevance, pulse (popular), or newest
maxResults	Integer	❌ No	100	Maximum number of images to scrape (range: 1-1000)
proxyConfiguration	Object	❌ No	{ useApifyProxy: true }	Proxy settings to avoid rate limiting

Note: 500px returns 100 results per page. The Actor automatically handles pagination to reach your desired maxResults.

---

📖 Usage Examples

Example 1: Basic Search

Search for "landscape photography" and get 100 results:

{
  "searchQuery": "landscape photography",
  "sort": "relevance",
  "maxResults": 100
}

Example 2: Popular Images

Get the most popular wildlife photos:

{
  "searchQuery": "wildlife",
  "sort": "pulse",
  "maxResults": 200
}

Example 3: Latest Uploads

Find the newest portrait photography:

{
  "searchQuery": "portrait",
  "sort": "newest",
  "maxResults": 150
}

Example 4: Specific Theme

Collect images for a specific theme or project:

{
  "searchQuery": "minimalist architecture",
  "sort": "relevance",
  "maxResults": 300
}

---

📤 Output Data

Each image result includes:

Field	Type	Description
id	String	Unique image identifier
legacyId	String	Legacy image ID for compatibility
title	String	Combined image name and description
name	String	Image name/title
description	String	Image description
url	String	Direct link to the image page on 500px
imageUrlLarge	String	Large image URL (max 2048px longest edge)
imageUrlSmall	String	Small image URL (max 600px longest edge)
width	Integer	Original image width in pixels
height	Integer	Original image height in pixels
widthLarge	Integer	Large version width
heightLarge	Integer	Large version height
widthSmall	Integer	Small version width
heightSmall	Integer	Small version height

Sample Output

{
  "id": "1234567890",
  "legacyId": "987654321",
  "title": "Sunset Over Mountains: A breathtaking view of golden hour in the Alps",
  "name": "Sunset Over Mountains",
  "description": "A breathtaking view of golden hour in the Alps",
  "url": "https://500px.com/photo/1234567890/sunset-over-mountains",
  "imageUrlLarge": "https://drscdn.500px.org/photo/1234567890/m=2048/v2?sig=...",
  "imageUrlSmall": "https://drscdn.500px.org/photo/1234567890/m=600/v2?sig=...",
  "width": 4000,
  "height": 3000,
  "widthLarge": 2048,
  "heightLarge": 1536,
  "widthSmall": 600,
  "heightSmall": 450
}

Data is delivered in clean JSON format, ready to download as JSON, CSV, Excel, or integrate via API.

---

❓ FAQ

Q: How many images can I scrape?
A: You can scrape between 1 and 1000 images per run. For larger datasets, run the Actor multiple times with different search queries.

Q: Do I need proxies?
A: No, but using Apify Proxy is highly recommended to avoid rate limiting from 500px.

Q: Can I download the actual image files?
A: The Actor provides direct URLs to the images. You can use these URLs to download the files separately or integrate with another Actor for downloading.

Q: Can I filter by photographer or category?
A: Currently, the Actor supports search queries and sorting. You can include photographer names in your search query (e.g., "landscape by photographer_name").