# Imgur Scraper (`conduit/imgur-scraper`) Actor 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. - **URL**: https://apify.com/conduit/imgur-scraper.md - **Developed by:** [Conduit](https://apify.com/conduit) (community) - **Categories:** Developer tools, Automation, Other - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $0.10 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 🖼️ 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): ```json {} ```` #### Example 2: Basic Search Search for "cats" and get 100 results sorted by highest score: ```json { "searchQuery": "cats", "sort": "score", "maxResults": 100 } ``` #### Example 3: Recent GIFs Get the newest animated GIFs from this week: ```json { "searchQuery": "funny", "sort": "time", "time": "week", "format": "anigif", "maxResults": 200 } ``` #### Example 4: Large Landscape Images Find large landscape images sorted by relevance: ```json { "searchQuery": "landscape", "sort": "relevance", "size": "lrg", "format": "jpg", "maxResults": 150 } ``` #### Example 5: Popular Today Get the most popular images from today: ```json { "searchQuery": "memes", "sort": "score", "time": "day", "maxResults": 50 } ``` #### Example 6: PNG Images Only Search for PNG images from this month: ```json { "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 ```json { "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 # Actor input Schema ## `searchQuery` (type: `string`): Search term to find images on Imgur (e.g., 'cats', 'landscape', 'memes') ## `sort` (type: `string`): How to sort the search results ## `time` (type: `string`): Filter results by when they were posted ## `format` (type: `string`): Filter by image format ## `size` (type: `string`): Filter by image size ## `maxResults` (type: `integer`): Maximum number of images to scrape ## `proxyConfiguration` (type: `object`): Proxy settings for the scraper. Using proxies is recommended to avoid rate limiting. ## Actor input object example ```json { "searchQuery": "cats", "sort": "score", "time": "all", "format": "any", "size": "any", "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `images` (type: `string`): Scraped images with metadata # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("conduit/imgur-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("conduit/imgur-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call conduit/imgur-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=conduit/imgur-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Imgur Scraper", "description": "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.", "version": "0.0", "x-build-id": "SOXiKoLwZQGZN6rzp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/conduit~imgur-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-conduit-imgur-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/conduit~imgur-scraper/runs": { "post": { "operationId": "runs-sync-conduit-imgur-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/conduit~imgur-scraper/run-sync": { "post": { "operationId": "run-sync-conduit-imgur-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Search term to find images on Imgur (e.g., 'cats', 'landscape', 'memes')", "default": "cats" }, "sort": { "title": "Sort By", "enum": [ "score", "relevance", "time" ], "type": "string", "description": "How to sort the search results", "default": "score" }, "time": { "title": "Time Posted", "enum": [ "all", "day", "week", "month", "year" ], "type": "string", "description": "Filter results by when they were posted", "default": "all" }, "format": { "title": "Format", "enum": [ "any", "jpg", "png", "gif", "anigif", "album" ], "type": "string", "description": "Filter by image format", "default": "any" }, "size": { "title": "Size", "enum": [ "any", "small", "med", "big", "lrg", "huge" ], "type": "string", "description": "Filter by image size", "default": "any" }, "maxResults": { "title": "Maximum Results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of images to scrape", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for the scraper. Using proxies is recommended to avoid rate limiting.", "default": { "useApifyProxy": true } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```