# Unsplash Email Scraper - Keyword & Location Targeting (`scrapido/unsplash-email-scraper`) Actor

🌄 Unsplash Email Scraper finds photographer emails by keyword and location. 🔓 Domain filtering, obfuscated-address decoding and duplicate handling. 📤 Export Unsplash leads to CSV, JSON or Excel for stock licensing outreach.

- **URL**: https://apify.com/scrapido/unsplash-email-scraper.md
- **Developed by:** [Scrapido](https://apify.com/scrapido) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

### Unsplash Email Scraper 🔍

**Unsplash Email Scraper** is a focused email scraping tool that extracts email addresses from Unsplash based on your keywords and filters. If you’re tired of manual email hunting, this actor helps marketers, recruiters, and sales pros build an Unsplash email extractor list faster—so your Unsplash lead generation can scale with less effort and better coverage. It also supports contact information harvesting and web scraping for email from publicly available sources.

***

### 🌟 Key Features of Unsplash Email Scraper

| Feature | Benefit |
|---|---|
| ✅ **Targeted Keyword Search** | Reach the exact Unsplash audience you need for lead generation |
| ✅ **Location Filtering** | Geo-target email extraction by city, region, or country |
| ✅ **Custom Domain Filter** | Focus on specific domains like `@gmail.com` or `@yahoo.com` |
| ✅ **Controlled Lead Volume** | Use `maxEmails` to cap total emails collected per run |
| ✅ **Proxy-Ready Scraping** | Built-in proxy support for more reliable data collection |
| ✅ **Resumable Progress** | Continues from your last run using saved progress state |
| ✅ **Structured Dataset Output** | Results are saved with keyword and profile metadata for easier analysis |

***

### 📥 Input — Unsplash Email Scraper Parameters

```json
{
  "keywords": ["manager", "founder"],
  "location": "",
  "customDomains": ["@gmail.com", "@yahoo.com"],
  "maxEmails": 20
}
```

| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| `keywords` | Array | ✅ Yes | — | Search terms used to find relevant Unsplash profiles for email address extraction. |
| `location` | String | No | `""` | Location to filter search results and narrow contact information harvesting by region. |
| `customDomains` | Array | No | `[]` | Filter results to specific email domains (for example `@gmail.com`, `@yahoo.com`). |
| `maxEmails` | Integer | No | `20` | Cap on total emails to collect. The actor stops once the limit is reached (helpful for controlling runtime and cost). |

***

### 📤 Output — What Unsplash Email Scraper Returns

The actor saves each result as a JSON record in your Apify dataset.

```json
{
  "keyword": "manager",
  "title": "Blue Sky Studio",
  "description": "We craft visual storytelling for brands. Media inquiries: press@blueskystudio.com.",
  "url": "https://unsplash.com/@blueskystudio",
  "email": "press@blueskystudio.com"
}
```

| Field | Type | Description |
|---|---|---|
| `keyword` | text | The keyword that surfaced this result during Unsplash data scraping. |
| `title` | text | Unsplash profile name or business title associated with the lead. |
| `description` | text | Profile bio or summary text where the email was found (metadata parsing). |
| `url` | link | Direct link to the Unsplash profile for reference. |
| `email` | text | Extracted email address from the Unsplash profile (web scraping for email). |

***

### 💻 How to Use Unsplash Email Scraper — Step-by-Step

1. **Open the Actor** — Find **Unsplash Email Scraper** on [Apify Store](https://apify.com/store).
2. **Enter Keywords** — Add job titles, roles, or terms matching your Unsplash lead generation goals.
3. **Set Location** *(optional)* — If you need regional targeting, fill `location` with a city, region, or country.
4. **Filter by Domain** *(optional)* — Use `customDomains` to extract emails only from domains you care about (e.g., `@gmail.com`).
5. **Set Max Emails** — Adjust `maxEmails` to control bulk email collection volume and run cost.
6. **Run the Actor** — Start the run and monitor progress in the logs.
7. **Export Results** — Open the dataset tab and export the leads (JSON / CSV) for your CRM or outreach workflows.

No coding required. You get a clean dataset ready for analysis and outreach.

***

### 💡 Best Use Cases for Unsplash Email Scraper

- 🎯 **B2B Lead Generation** — Build an Unsplash email list for targeted outbound campaigns
- 📣 **Email Marketing** — Source fresh contact information harvesting inputs for sequences
- 🤝 **Recruitment** — Reach relevant professionals discovered via Unsplash data scraping
- 🔬 **Market Research** — Find industry voices and communities using web scraping for email
- 📊 **CRM Enrichment** — Add extracted email addresses to existing lead records for better data enrichment

***

### Disclaimer

This actor only accesses **publicly available data** on Unsplash. It does not scrape private profiles, authenticated content, or password-protected pages. You are responsible for ensuring your use complies with Unsplash Terms of Service, and applicable privacy and anti-spam laws (including GDPR/CCPA where relevant). This tool is intended for legitimate purposes such as lead generation, research, and marketing compliance. For data-removal requests, contact 📧 <scrapido.support@gmail.com>.

***

### 🆘 Support & Feedback

Have a question or found an issue with the **Unsplash Email Scraper**? We're here to help.

- 🐞 **Bug Reports:** Reach out with details so we can investigate
- ✨ **Custom Solutions & Feature Requests:** Tell us what you need and we’ll review it
- 📧 **Email:** <scrapido.support@gmail.com>

Your feedback helps improve email scraping tool results—especially for bulk email collection and contact information harvesting workflows.

### Multiple Email Types

**Email Types** replaces the old single Audience Type choice: select as many
kinds of mailbox as you want and the run chases all of them together.

| Type | What it matches |
| --- | --- |
| Personal / free webmail | Gmail, Outlook, Yahoo, iCloud, AOL, Proton, ... |
| Business / corporate | Company domains - free webmail and institutions excluded |
| Education (.edu / .ac) | `.edu`, `.ac.uk`, `.edu.au`, `.ac.in` and other academic suffixes |
| Government (.gov / .mil) | `.gov`, `.mil`, `.gov.uk`, `.gc.ca`, ... |
| Non-profit (.org) | `.org`, `.ngo`, `.org.uk`, ... |

Each selected type contributes its own Google dork patterns *and* its own domain
test, so a result is only kept if it genuinely belongs to the type that found
it. Every row carries an `emailType` field recording which one that was.

Suffixes are matched as real domain suffixes, so `cs.mit.edu` counts as
Education while `notedu.com` does not.

Setting **Custom Email Domains** still overrides everything: an explicit domain
list is a manual override and replaces the type-driven patterns. The legacy
`audienceType` value is still accepted, so saved inputs keep working.

# Actor input Schema

## `keywords` (type: `array`):

A list of keywords or queries to search for.

## `audienceType` (type: `string`):

Business Emails runs contextual discovery patterns tuned for company contact pages ("email us at", "contact@", careers, bookings, ...) and filters out consumer webmail domains. Consumer Emails instead searches gmail.com, yahoo.com, outlook.com, hotmail.com and icloud.com directly.

## `maxEmails` (type: `integer`):

Maximum number of emails to collect. The scraper will stop once this limit is reached. Setting a higher limit allows for more potential results but doesn't guarantee reaching that number. This helps save costs by controlling scraping time.

## `customDomains` (type: `array`):

Optional manual override — provide specific email domains to search for (e.g. @hubspot.com) instead of using Audience Type. Leave empty to use Audience Type.

## `emailTypes` (type: `array`):

Which kinds of mailbox to hunt for. Pick as many as you like - each type contributes its own set of Google search patterns and its own domain filter, and every result records the type it was found as. Personal = free webmail (Gmail, Outlook, Yahoo, iCloud). Business = company domains, excluding free webmail and institutions. Education = .edu / .ac.uk and friends. Government = .gov / .mil. Non-profit = .org.

## Actor input object example

```json
{
  "keywords": [
    "photographer",
    "creative studio"
  ],
  "audienceType": "Consumer Emails",
  "maxEmails": 20,
  "customDomains": [],
  "emailTypes": [
    "Personal",
    "Business"
  ]
}
```

# Actor output Schema

## `dataset` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "photographer",
        "creative studio"
    ],
    "customDomains": [],
    "emailTypes": [
        "Personal",
        "Business"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapido/unsplash-email-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keywords": [
        "photographer",
        "creative studio",
    ],
    "customDomains": [],
    "emailTypes": [
        "Personal",
        "Business",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("scrapido/unsplash-email-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "photographer",
    "creative studio"
  ],
  "customDomains": [],
  "emailTypes": [
    "Personal",
    "Business"
  ]
}' |
apify call scrapido/unsplash-email-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapido/unsplash-email-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/pyLDAAIvIFcz2pBDE/builds/I0xggP9VfojFPhiPy/openapi.json