# Pexels Stock Image Scraper (`shahidirfan/pexels-stock-image-scraper`) Actor Bulk download high-resolution royalty-free images from Pexels. Capture image URLs, titles, photographer info, dimensions & metadata. Ideal for blog automation, design assets, content creation, AI training datasets & stock image libraries. Zero licensing restrictions. - **URL**: https://apify.com/shahidirfan/pexels-stock-image-scraper.md - **Developed by:** [Shahid Irfan](https://apify.com/shahidirfan) (community) - **Categories:** Automation, Developer tools, Other - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Pexels Stock Image Scraper Extract rich stock photo search results from Pexels with a keyword or a working Pexels search URL. Collect titles, alt text, image links, photographer details, flattened reaction and badge data, colors, tags, dimensions, and search context in a clean dataset that is ready for research, content pipelines, and cataloging. ### Features - **Keyword or URL input** — Start from a simple keyword or from an existing Pexels photo search URL - **Rich photo output** — Collect photo metadata, photographer details, image variants, tags, colors, reaction counts, badge counts, and publication dates - **Failure diagnosis path** — When requests fail, the actor reads its API discovery notes and retries diagnostic request patterns before giving up - **Pagination support** — Continue through multiple result pages until your target count is reached - **Filter-aware scraping** — Reuse filters already present in a working Pexels search URL - **Clean dataset items** — Null values are removed before items are stored ### Use Cases #### Content Research Build reference sets for blogs, social campaigns, landing pages, and creative briefs. Keep the image metadata alongside the source links so your team can review options quickly. #### Visual Trend Monitoring Track what kinds of photos appear for seasonal, commercial, or topical searches. Use tags, colors, and photographer metadata for broader analysis. #### Asset Discovery Collect batches of relevant image candidates for newsletters, presentations, and creative production workflows. Start from one search URL and expand through multiple pages. #### Dataset Building Create structured image-search datasets for downstream scoring, deduplication, enrichment, or reporting. Export results in JSON, CSV, Excel, and other supported formats. --- ### Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `url` | String | No | `https://www.pexels.com/search/summer/` | Pexels photo search URL to use as the starting point | | `keyword` | String | No | `"summer"` | Search keyword to use when `url` is not provided, or to override the keyword inside the URL | | `results_wanted` | Integer | No | `20` | Maximum number of photo results to collect | | `max_pages` | Integer | No | `10` | Safety cap on paginated requests | | `page` | Integer | No | `1` | Page number to start from | | `orientation` | String | No | — | Optional orientation filter such as `horizontal`, `vertical`, or `square` | | `size` | String | No | — | Optional size filter | | `color` | String | No | — | Optional dominant color filter | | `locale` | String | No | `"en-us"` | Locale for the search request | | `proxyConfiguration` | Object | No | `{"useApifyProxy": false}` | Proxy settings for more reliable access | --- ### Output Data Each dataset item can contain: | Field | Type | Description | |-------|------|-------------| | `id` | String | Pexels photo identifier | | `title` | String | Photo title | | `description` | String | Photo description when available | | `alt` | String | Alternative description text | | `photo_url` | String | Pexels photo detail page URL | | `download_page_url` | String | Pexels download page URL | | `download_image_url` | String | Direct download image URL | | `small_image_url` | String | Small preview image URL | | `medium_image_url` | String | Medium preview image URL | | `large_image_url` | String | Large preview image URL | | `width` | Integer | Image width in pixels | | `height` | Integer | Image height in pixels | | `aspect_ratio` | Number | Image aspect ratio | | `license` | String | License label | | `publish_at` | String | Publication timestamp | | `tags` | Array | Pexels tags for the image | | `colors` | Array | Color palette values | | `photographer_name` | String | Photographer display name | | `photographer_slug` | String | Photographer slug | | `photographer_location` | String | Photographer location | | `photographer_hero` | Boolean | Whether the photographer has hero status | | `photographer_active_hero` | Boolean | Whether the photographer currently has active hero status | | `photographer_badges` | Array | Flattened photographer badge labels | | `photographer_badges_count` | Integer | Number of photographer badges | | `reactions_emotional_count` | Integer | Emotional reaction count | | `reactions_technical_count` | Integer | Technical reaction count | | `reactions_stylistic_count` | Integer | Stylistic reaction count | | `reactions_emotional_reacted` | Boolean | Whether the emotional reaction is active | | `reactions_technical_reacted` | Boolean | Whether the technical reaction is active | | `reactions_stylistic_reacted` | Boolean | Whether the stylistic reaction is active | | `user` | Object | Photographer profile metadata | | `image` | Object | Image variant URLs | | `reactions` | Object | Reaction counters and flags | | `search` | Object | Search context, page, locale, and result counts | --- ### Usage Examples #### Search by Keyword Use a simple keyword and collect the first 20 image results: ```json { "keyword": "summer", "results_wanted": 20 } ```` #### Use a Pexels Search URL Start from a working Pexels search page: ```json { "url": "https://www.pexels.com/search/summer/", "results_wanted": 30, "max_pages": 3 } ``` #### Continue from a Later Page with Filters Resume from a later page and keep the same search style: ```json { "url": "https://www.pexels.com/search/summer/?page=2&orientation=vertical", "results_wanted": 40, "max_pages": 4 } ``` *** ### Sample Output ```json { "id": 8455817, "type": "photo", "slug": "color-flipflops-on-the-sand", "title": "Color Flipflops on the Sand", "description": "Vibrant flip flops stand in the sand against a clear blue sky, symbolizing a perfect summer beach day.", "alt": "Vibrant flip flops stand in the sand against a clear blue sky, symbolizing a perfect summer beach day.", "photo_url": "https://www.pexels.com/photo/color-flipflops-on-the-sand-8455817/", "download_page_url": "https://www.pexels.com/photo/8455817/download/", "download_image_url": "https://images.pexels.com/photos/8455817/pexels-photo-8455817.jpeg?cs=srgb&dl=pexels-rdne-8455817.jpg&fm=jpg", "large_image_url": "https://images.pexels.com/photos/8455817/pexels-photo-8455817.jpeg?auto=compress&cs=tinysrgb&w=1440", "width": 4442, "height": 6663, "aspect_ratio": 0.6666666666666666, "license": "Pexels", "publish_at": "2021-06-23T22:00:45.455Z", "tags": [ "beach", "summer", "vacation" ], "colors": [ "#008b8b", "#00bfff", "#cd5c5c" ], "photographer_name": "RDNE Stock project", "photographer_slug": "rdne", "photographer_location": "Los Angeles", "photographer_hero": false, "photographer_active_hero": false, "photographer_badges": [], "photographer_badges_count": 0, "reactions_emotional_count": 0, "reactions_technical_count": 0, "reactions_stylistic_count": 0, "search": { "query": "summer", "locale": "en-us", "page": 1, "total_photo_results": 5186 } } ``` *** ### Tips for Best Results #### Start with Real Search URLs - Use a working Pexels photo search URL when you already know the page and filters you want - Keep the URL focused on photo search pages, not videos or user pages #### Keep QA Runs Fast - Use `results_wanted: 20` for quick verification runs - Increase `max_pages` only when you need deeper pagination #### Use Filters Deliberately - Pass `orientation`, `size`, or `color` only when they matter to your use case - If your URL already contains filters, the actor can reuse them automatically #### Proxy Usage - Start without a proxy for small runs - Enable Apify Proxy if you need more stable access at scale *** ### Integrations Connect your dataset with: - **Google Sheets** — Review image candidates in spreadsheets - **Airtable** — Build searchable asset tables - **Make** — Send new results into automated workflows - **Zapier** — Trigger downstream actions from completed runs - **Webhooks** — Deliver results to your own services #### Export Formats - **JSON** — For APIs, apps, and enrichment pipelines - **CSV** — For spreadsheet review - **Excel** — For stakeholder reporting - **XML** — For custom integrations *** ### Frequently Asked Questions #### Can I use either a keyword or a URL? Yes. The actor supports both. A keyword-only run is useful for simple searches, while a URL keeps existing search filters and page context. #### Does the actor support paginated runs? Yes. It keeps requesting additional result pages until it reaches `results_wanted`, the search ends, or `max_pages` is reached. #### Will null fields be stored? No. Dataset items are cleaned before storage so null values are removed. #### Can I start from page 2 or page 3? Yes. Use the `page` input or provide a Pexels search URL that already includes a `page` query parameter. #### Does it support video or user search URLs? No. This actor is focused on Pexels photo search results. #### What happens if I provide both `url` and `keyword`? The actor can reuse the URL context while applying the provided keyword as the active search query. *** ### Support For issues or feature requests, use the Apify Console for the actor. #### Resources - [Apify Documentation](https://docs.apify.com/) - [Apify API Reference](https://docs.apify.com/api/v2) - [Apify Schedules](https://docs.apify.com/platform/schedules) *** ### Legal Notice This actor is intended for lawful data collection and research workflows. Users are responsible for complying with Pexels terms, platform rules, and applicable laws when collecting and using data. # Actor input Schema ## `url` (type: `string`): Optional Pexels photo search URL such as https://www.pexels.com/search/summer/ or a filtered search URL. ## `keyword` (type: `string`): Search keyword to use when URL is not provided, or to override the keyword inside the URL. ## `results_wanted` (type: `integer`): Maximum number of photo results to collect. ## `max_pages` (type: `integer`): Safety limit for paginated API requests. ## `page` (type: `integer`): Page number to start from. ## `orientation` (type: `string`): Optional orientation filter such as horizontal, vertical, or square. ## `size` (type: `string`): Optional size filter from the search URL. ## `color` (type: `string`): Optional dominant color filter from the search URL. ## `locale` (type: `string`): Optional locale override such as en-us or de-de. ## `proxyConfiguration` (type: `object`): Use Apify Proxy for more reliable access when needed. ## Actor input object example ```json { "url": "https://www.pexels.com/search/summer/", "keyword": "summer", "results_wanted": 20, "max_pages": 10, "page": 1, "locale": "en-us", "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (type: `string`): No description # 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 = { "url": "https://www.pexels.com/search/summer/", "keyword": "summer", "results_wanted": 20, "max_pages": 10, "page": 1, "locale": "en-us" }; // Run the Actor and wait for it to finish const run = await client.actor("shahidirfan/pexels-stock-image-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 = { "url": "https://www.pexels.com/search/summer/", "keyword": "summer", "results_wanted": 20, "max_pages": 10, "page": 1, "locale": "en-us", } # Run the Actor and wait for it to finish run = client.actor("shahidirfan/pexels-stock-image-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 '{ "url": "https://www.pexels.com/search/summer/", "keyword": "summer", "results_wanted": 20, "max_pages": 10, "page": 1, "locale": "en-us" }' | apify call shahidirfan/pexels-stock-image-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=shahidirfan/pexels-stock-image-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Pexels Stock Image Scraper", "description": "Bulk download high-resolution royalty-free images from Pexels. Capture image URLs, titles, photographer info, dimensions & metadata. Ideal for blog automation, design assets, content creation, AI training datasets & stock image libraries. Zero licensing restrictions.", "version": "0.0", "x-build-id": "xpy3haxlOtyoINFGW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shahidirfan~pexels-stock-image-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shahidirfan-pexels-stock-image-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/shahidirfan~pexels-stock-image-scraper/runs": { "post": { "operationId": "runs-sync-shahidirfan-pexels-stock-image-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/shahidirfan~pexels-stock-image-scraper/run-sync": { "post": { "operationId": "run-sync-shahidirfan-pexels-stock-image-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": { "url": { "title": "Pexels Search URL", "type": "string", "description": "Optional Pexels photo search URL such as https://www.pexels.com/search/summer/ or a filtered search URL." }, "keyword": { "title": "Keyword", "type": "string", "description": "Search keyword to use when URL is not provided, or to override the keyword inside the URL." }, "results_wanted": { "title": "Maximum number of results", "minimum": 1, "type": "integer", "description": "Maximum number of photo results to collect.", "default": 20 }, "max_pages": { "title": "Maximum pages", "minimum": 1, "type": "integer", "description": "Safety limit for paginated API requests.", "default": 10 }, "page": { "title": "Start page", "minimum": 1, "type": "integer", "description": "Page number to start from.", "default": 1 }, "orientation": { "title": "Orientation", "type": "string", "description": "Optional orientation filter such as horizontal, vertical, or square." }, "size": { "title": "Size", "type": "string", "description": "Optional size filter from the search URL." }, "color": { "title": "Color", "type": "string", "description": "Optional dominant color filter from the search URL." }, "locale": { "title": "Locale", "type": "string", "description": "Optional locale override such as en-us or de-de." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use Apify Proxy for more reliable access when needed.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```