# Unsplash Email Scraper - Bulk Keywords, Decodes Hidden Emails (`code-beat/unsplash-email-scraper-ultra-fast-and-precise`) Actor

🌄 Unsplash Email Scraper extracts photographer contact emails in bulk by keyword. 🔓 Decodes obfuscated addresses, filters by domain, dedups. 📷 Ideal for stock licensing, brand shoots & creative talent sourcing.

- **URL**: https://apify.com/code-beat/unsplash-email-scraper-ultra-fast-and-precise.md
- **Developed by:** [Code Beat](https://apify.com/code-beat) (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 $1.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/actors/running/actors-in-store.md#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** helps you extract emails from Unsplash profiles using targeted keywords, making Unsplash lead generation faster and more efficient for marketers, recruiters, sales pros, researchers, and outreach teams. It’s built to function as an Unsplash email extractor, helping you scrape Unsplash emails and build a more focused contact list from publicly available data. ✨

### 🌟 Key Features of Unsplash Email Scraper

| Feature | Benefit |
|---|---|
| ✅ **Targeted Keyword Search** | Use your keywords to find relevant Unsplash profiles and uncover contact details faster. |
| ✅ **Custom Email Domain Filters** | Narrow results to selected domains like `@gmail.com` or `@yahoo.com` for more relevant outreach. |
| ✅ **Location Filtering** | Add a location to focus on a specific region when building an Unsplash contact scraper workflow. |
| ✅ **Controlled Result Limits** | Set a maximum number of emails to keep your run efficient and cost-conscious. |
| ✅ **Real-Time Saving** | Results are saved as they’re found, reducing the risk of losing progress on longer runs. |
| ✅ **Built-In Proxy Support** | Includes built-in proxy support for more reliable scraping on public web data. |
| ✅ **Resume-Friendly Runs** | Progress is stored so you can continue work more smoothly if a run is interrupted. |

### 📥 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 | `["manager", "founder"]` | A list of keywords or queries used to find relevant Unsplash profiles. |
| `location` | String | No | `""` | Optional location filter for narrowing search results by place or region. |
| `customDomains` | Array | No | `["@gmail.com", "@yahoo.com"]` | Email domains to focus on when extracting contacts, such as personal or company domains. |
| `maxEmails` | Integer | No | `20` | Maximum number of emails to collect before the actor stops. |

### 📤 Output — What Unsplash Email Scraper Returns

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

```json
{
  "keyword": "founder",
  "title": "Jessica Miller",
  "description": "Product designer and creative director based in London. Open to collaborations and brand work.",
  "url": "https://unsplash.com/@jessicamiller",
  "email": "jessica.miller@gmail.com"
}
```

| Field | Label | Format | Description |
|---|---|---|---|
| `keyword` | Keyword | text | The keyword that produced the result. |
| `title` | Title | text | The profile title returned in the dataset row. |
| `description` | Description | text | The text description associated with the result. |
| `url` | Url | link | A direct link to the Unsplash profile or related public page. |
| `email` | Email | text | The extracted email address. |

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

1. **Open the Actor** — Find **Unsplash Email Scraper** in the Apify Store and open its page.
2. **Enter Keywords** — Add one or more keywords such as roles, professions, or niches relevant to your target audience.
3. **Set Location** — Optionally add a location to narrow the search to a specific area.
4. **Filter by Domain** — Add one or more email domains to focus your results.
5. **Set Max Emails** — Choose how many emails you want the run to collect.
6. **Run the Actor** — Start the actor and watch the logs as results are found.
7. **Export Results** — Download the dataset with your scraped Unsplash contact data.

*No coding required. Results ready in minutes.* 🚀

### 💡 Best Use Cases for Unsplash Email Scraper

- 🎯 **Unsplash Lead Generation** — Build targeted contact lists from public Unsplash profiles for outreach.
- 📣 **Email Marketing** — Find contacts for newsletters, campaigns, and follow-up sequences.
- 🤝 **Recruitment** — Discover creators and professionals you may want to contact directly.
- 🔬 **Market Research** — Study public creator profiles and collect useful contact data at scale.
- 📊 **CRM Enrichment** — Add email details to existing records for cleaner lead management.

### Disclaimer

This actor only accesses **publicly available data** on Unsplash. It does not scrape private profiles, authenticated content, or password-protected pages. Users are solely responsible for ensuring their use complies with Unsplash’s Terms of Service, GDPR, CCPA, and applicable anti-spam laws. This tool is intended for legitimate purposes only, including research, lead generation, and marketing in compliance with local regulations. For data-removal requests, contact 📧 <codebeatapi@gmail.com>.

### 🆘 Support & Feedback

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

- 🐞 **Bug Reports:** Let us know if you spot unexpected behavior or missing results.
- ✨ **Custom Solutions & Feature Requests:** Reach out if you need a tailored workflow or enhancement.
- 📧 **Email:** <codebeatapi@gmail.com>

Your feedback shapes the roadmap — we read every message.

### Country & Time Targeting

Both filters are applied to the Google query itself, so they shape which pages
the dork is answered from rather than filtering after the fact.

**Target Country** - runs the search as if from that country (`gl`). Turn on
**Strict country filter** to additionally restrict results to pages Google
attributes to it (`cr=countryXX`); that is much tighter and returns noticeably
fewer results. Leave the country on *Global (no country filter)* for worldwide
results.

**Result Language** - restricts results to a single language (`hl` + `lr`).

**Time Range** - limits results to a publication window: past hour, 24 hours,
week, month, year, or an explicit *Custom range* using **Custom range: from** /
**to** in `YYYY-MM-DD` form. A page Google indexed last week is far more likely
to carry a live mailbox than one it last saw five years ago.

Selecting *Custom range* without either date falls back to no time filter rather
than searching all of time by accident.

# Actor input Schema

## `scrapeMode` (type: `string`):

Find New Emails (default) searches Airbnb by keyword. Clean My List skips searching entirely and instead runs the emails you paste into Email List (below) through the same deliverability checks.

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

A list of keywords or queries to search for.

## `location` (type: `string`):

Location to filter search results.

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

List of custom email domains

## `emailList` (type: `array`):

Paste the emails you want checked for deliverability. Only used when Scrape Mode is set to "Clean My List".

## `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.

## `verificationMode` (type: `string`):

Quick Check (default) validates syntax and MX records only - fast, no added latency. Deep Check additionally flags disposable-domain addresses and checks each domain against a public spam blocklist (Spamhaus DBL). Off skips validation entirely.

## `minQualityScore` (type: `number`):

Drop any contact whose quality score (0.0-1.0) falls below this. Leave at 0 for no filter.

## `excludeCatchAll` (type: `boolean`):

Drop contacts on domains confirmed to accept mail for any address (only applies when that signal is available).

## `requireMxValid` (type: `boolean`):

Drop any contact whose domain has no valid mail server (MX record).

## `targetCountry` (type: `string`):

Ask Google to answer as if searching from this country. Leave on "Global (no country filter)" for worldwide results.

## `strictCountry` (type: `boolean`):

Restrict results to pages Google attributes to the target country (cr=countryXX), instead of only preferring them. Much tighter targeting, noticeably fewer results.

## `searchLanguage` (type: `string`):

Restrict results to one language. Leave on "Any language" for no filter.

## `timeRange` (type: `string`):

Only return pages Google indexed within this window. Recent pages are more likely to hold a mailbox that still works.

## `customDateFrom` (type: `string`):

Only used when Time Range is "Custom range". Format: YYYY-MM-DD.

## `customDateTo` (type: `string`):

Only used when Time Range is "Custom range". Format: YYYY-MM-DD.

## Actor input object example

```json
{
  "scrapeMode": "Find New Emails",
  "keywords": [
    "photographer",
    "creative studio"
  ],
  "location": "",
  "customDomains": [
    "@gmail.com",
    "@yahoo.com"
  ],
  "emailList": [],
  "maxEmails": 20,
  "verificationMode": "Quick Check",
  "minQualityScore": 0,
  "excludeCatchAll": false,
  "requireMxValid": false,
  "targetCountry": "Global (no country filter)",
  "strictCountry": false,
  "searchLanguage": "",
  "timeRange": "Any time",
  "customDateFrom": "",
  "customDateTo": ""
}
```

# 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"
    ],
    "location": "",
    "customDomains": [
        "@gmail.com",
        "@yahoo.com"
    ],
    "emailList": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("code-beat/unsplash-email-scraper-ultra-fast-and-precise").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",
    ],
    "location": "",
    "customDomains": [
        "@gmail.com",
        "@yahoo.com",
    ],
    "emailList": [],
}

# Run the Actor and wait for it to finish
run = client.actor("code-beat/unsplash-email-scraper-ultra-fast-and-precise").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"
  ],
  "location": "",
  "customDomains": [
    "@gmail.com",
    "@yahoo.com"
  ],
  "emailList": []
}' |
apify call code-beat/unsplash-email-scraper-ultra-fast-and-precise --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,code-beat/unsplash-email-scraper-ultra-fast-and-precise"
        }
    }
}

```

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/fb4iMYMFti2DU50mA/builds/Q3xzCdkHUxh732qRz/openapi.json