🖼️ Imgur Image Scraper

Extract images from Imgur.com, the popular image hosting and sharing platform. Get image metadata including titles, multiple image sizes, and direct links to image pages with advanced filtering options and automatic pagination support.

---

✨ Why Use Imgur Image Scraper?

• ⚡ Fast & Efficient - Direct HTML parsing with Cheerio delivers results quickly
• 🎯 Advanced Filtering - Filter by sort order, time range, format, and size
• 📈 Scalable - Scrape from 1 to 1000 images with automatic pagination
• 🎨 Multiple Sizes - Access both full-size and medium-size image versions
• 📊 Clean Output - Structured JSON data ready for analysis, galleries, or integration

---

📥 Input Parameters

Parameter	Type	Required	Default	Description
searchQuery	String	❌ No	"cats"	Search term to find images (e.g., "cats", "landscape", "memes")
sort	String	❌ No	"score"	Sort order: score (highest scoring), relevance (most relevant), or time (newest first)
time	String	❌ No	"all"	Time filter: all, day, week, month, or year
format	String	❌ No	"any"	Image format: any, jpg, png, gif, anigif, or album
size	String	❌ No	"any"	Image size: any, small (≤500px), med (500-2000px), big (2000-5000px), lrg (5000-10000px), or huge (≥10000px)
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: The Actor automatically handles pagination to reach your desired maxResults. Imgur may return varying numbers of results per page.

---

📖 Usage Examples

Example 1: Use Defaults

Run with all default settings (searches for "cats", sorted by score, 100 results):

{}

Example 2: Basic Search

Search for "cats" and get 100 results sorted by highest score:

{
  "searchQuery": "cats",
  "sort": "score",
  "maxResults": 100
}

Example 3: Recent GIFs

Get the newest animated GIFs from this week:

{
  "searchQuery": "funny",
  "sort": "time",
  "time": "week",
  "format": "anigif",
  "maxResults": 200
}

Example 4: Large Landscape Images

Find large landscape images sorted by relevance:

{
  "searchQuery": "landscape",
  "sort": "relevance",
  "size": "lrg",
  "format": "jpg",
  "maxResults": 150
}

Example 5: Popular Today

Get the most popular images from today:

{
  "searchQuery": "memes",
  "sort": "score",
  "time": "day",
  "maxResults": 50
}

Example 6: PNG Images Only

Search for PNG images from this month:

{
  "searchQuery": "art",
  "sort": "relevance",
  "time": "month",
  "format": "png",
  "maxResults": 300
}

---

📤 Output Data

Each image result includes:

Field	Type	Description
title	String	Image title from alt attribute
url	String	Direct link to the image page on Imgur
imageUrl	String	Full-size image URL (.jpg format)
imageUrlMedium	String	Medium-size image URL (m.jpg format)

Sample Output

{
  "title": "Cute cat playing with yarn",
  "url": "https://imgur.com/a/abc123",
  "imageUrl": "https://i.imgur.com/abc123.jpg",
  "imageUrlMedium": "https://i.imgur.com/abc123m.jpg"
}

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 or filters.

Q: Do I need proxies?
A: Using Apify Proxy is highly recommended to avoid rate limiting and IP blocking from Imgur. The Actor includes proxy support by default.

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: What's the difference between imageUrl and imageUrlMedium?
A: imageUrl provides the full-size image, while imageUrlMedium provides a smaller, optimized version (typically with 'm' suffix). Use the medium version for thumbnails and the full version for detailed viewing.

Q: Why am I getting blocked?
A: Imgur may block requests if you make too many requests too quickly. The Actor includes delays between pages and proxy support to mitigate this. If you're still getting blocked, try:

• Using Apify Proxy
• Reducing maxResults
• Adding longer delays between requests