# Vimeo Email Scraper (`email_scraper/vimeo-email-scraper`) Actor

Vimeo Email Scraper extracts publicly indexed email addresses from Vimeo search results using targeted keywords, locations, and custom email domains. Build structured Vimeo leads for outreach, research, marketing, and contact discovery with flexible filtering and deduplication.

- **URL**: https://apify.com/email\_scraper/vimeo-email-scraper.md
- **Developed by:** [Email Scraper](https://apify.com/email_scraper) (community)
- **Categories:**
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.49 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

### 🔍 Vimeo Email Scraper – Overview

**Vimeo Email Scraper** is an Apify Actor designed to discover publicly indexed email addresses associated with Vimeo pages using targeted search keywords, optional locations, and configurable email-domain filters.

It is useful for marketers, agencies, researchers, sales teams, creators, recruiters, and lead-generation workflows that need structured Vimeo contact data from publicly searchable pages.

Instead of manually searching Vimeo pages and copying contact information one by one, **Vimeo Email Scraper** searches for relevant Vimeo results based on your terms, identifies matching email addresses in available result descriptions, removes duplicate emails, and stores the extracted lead data in an Apify Dataset.

> **💡 What does Vimeo Email Scraper do?**
>
> - Searches for Vimeo-related pages using your keywords
> - Supports optional country, state, or city targeting
> - Filters results by email-domain suffixes
> - Lets you exclude unwanted words or phrases
> - Deduplicates collected email addresses
> - Saves results as structured dataset records
> - Supports multiple keywords and domains in one run

### 🔹 Vimeo Email Scraper – Key Features

**Vimeo Email Scraper** provides several controls for narrowing or expanding your lead discovery workflow.

- **Keyword-based Vimeo search** — Search for creators, marketers, professionals, businesses, niches, or other relevant terms.

- **Multiple keyword support** — Add several search terms to increase coverage. Specific combinations such as `Fitness Coach`, `Video Producer`, or `Content Creator` can produce more focused results than a broad single keyword.

- **Location targeting** — Enter a country, state, or city to narrow the search toward a geographic market.

- **Custom email domains** — Search for addresses using domains such as `@gmail.com`, `@yahoo.com`, `@outlook.com`, or relevant business domains.

- **Exclude words and phrases** — Skip descriptions containing unwanted terms before email extraction.

- **Configurable email target** — Set the maximum number of emails to target for each keyword and domain combination, from 1 up to 10,000.

- **Duplicate prevention** — The scraper maintains a set of already discovered email addresses so the same email is not repeatedly added to the dataset.

- **Structured dataset output** — Each discovered address is stored together with the related keyword, title, description, and URL.

> **✅ Why Use Vimeo Email Scraper**
>
> - Reduce manual Vimeo lead research
> - Build structured contact datasets
> - Explore niche-specific creator and business prospects
> - Combine keywords with location targeting
> - Search multiple email-domain patterns
> - Exclude irrelevant profile descriptions
> - Collect unique email addresses across a run

### 📊 Vimeo Email Scraper – What Data Can You Extract?

The **Vimeo Email Scraper** output is designed for lead discovery and contact research. Each collected record contains information associated with the Vimeo search result where the email address was found.

| Field         | Description                                                  |
| ------------- | ------------------------------------------------------------ |
| `network`     | Identifies the source network as `Vimeo.com`.                |
| `keyword`     | The keyword used for the search that produced the result.    |
| `title`       | Title of the indexed Vimeo search result.                    |
| `description` | Search-result description associated with the result.        |
| `url`         | URL of the discovered result.                                |
| `email`       | Email address extracted from the available description text. |

The dataset view is organized around the primary lead fields: keyword, title, description, URL, and email. The `network` value is also included in the stored result.

> **📦 Output / Data Fields**
>
> - **Keyword:** Search term responsible for the lead
> - **Title:** Result title
> - **Description:** Public search-result description
> - **URL:** Related result link
> - **Email:** Matching email address
> - **Network:** Vimeo.com source identifier

### 🛠️ How to Use Vimeo Email Scraper

Using **Vimeo Email Scraper** starts with defining the audience or topic you want to research.

#### 🔍 1. Add your keywords

Enter one or more keywords in the **Keywords or Queries** field.

Good keyword choices are specific and commercially meaningful. For example:

- `Content Creator`
- `Video Marketer`
- `Fitness Coach`
- `Music Producer`
- `Real Estate Video`
- `Digital Marketing Agency`
- `Corporate Video Producer`

Specific keyword variations can help uncover different groups of publicly indexed Vimeo results.

#### 🌍 2. Add an optional location

The **Region / Location** field can contain a country, state, or city.

Examples:

- `New York`
- `California`
- `London`
- `Canada`
- `Australia`

Leave this field empty when you want the search to operate without a geographic filter.

#### 📧 3. Choose email domains

In **E-mail domain suffixes**, specify the email endings you want to search for.

Examples:

```text
@gmail.com
@yahoo.com
@outlook.com
@hotmail.com
@icloud.com
@company.com
```

Using several domain suffixes can broaden the possible contact coverage.

#### 🚫 4. Add exclusion terms

Use **Exclude words** when you do not want results containing particular words or phrases.

Examples:

```text
crypto
onlyfans
adult content
```

Single words are matched as whole words without case sensitivity, while phrases are matched without case sensitivity as text phrases.

#### 🎯 5. Set the maximum email target

The **maxEmails** value controls the target for each keyword + domain combination.

For example, with:

```text
3 keywords
2 domains
20 maxEmails
```

the Actor processes six keyword-domain combinations, with a target of up to 20 emails for each combination.

This means the theoretical target can reach:

```text
3 × 2 × 20 = 120 records
```

However, the scraper cannot create addresses that are not publicly present in the searchable results, so requested targets are not guaranteed.

### 🔎 How to Get More Vimeo Email Results

The quality and size of **Vimeo Email Scraper** results depend heavily on search coverage.

Start with several closely related keywords instead of relying on one broad term. For example, a campaign targeting fitness professionals could use:

```text
Fitness Coach
Fitness Trainer
Online Fitness Coach
Fitness Influencer
Personal Trainer
Fitness Content Creator
```

You can then combine those terms with several relevant email domains.

Location targeting works best when geographic relevance matters. For a global prospecting workflow, leaving the location blank may provide broader discovery.

> **💡 Search Optimization Tip**
>
> - Start with precise keywords
> - Add related keyword variations
> - Test several relevant email domains
> - Remove overly restrictive location filters when results are sparse
> - Increase `maxEmails` when deeper coverage is appropriate
> - Use exclusion terms to reduce unwanted categories

### ⚙️ Can You Search Vimeo Email Addresses by Location?

Yes. **Vimeo Email Scraper** supports an optional location field that is added to the search criteria.

You can enter a city, state, country, or another geographic phrase.

This is useful for campaigns such as:

- Finding video professionals in New York
- Researching creators in Canada
- Discovering agencies in London
- Exploring marketing prospects in Australia

Location is optional. Leaving it blank allows broader search discovery.

### 📧 Can You Search Multiple Email Domains?

Yes. **Vimeo Email Scraper** accepts a list of custom email-domain suffixes.

For example:

```json
{
  "customDomains": [
    "@gmail.com",
    "@yahoo.com",
    "@outlook.com"
  ]
}
```

The Actor processes each keyword-domain combination independently. This makes it possible to test different email ecosystems during the same run.

Business-specific domains can also be supplied when relevant to your research.

### 🚫 How Does the Exclude Words Filter Work?

The exclude filter is applied to the search-result description before email addresses are collected.

When a description contains an excluded word or phrase, the complete result snippet is skipped.

For example, with:

```text
excludeWords:
[
  "crypto",
  "onlyfans"
]
```

a result description containing one of those terms will not contribute an email address.

Single words use whole-word matching, while multi-word phrases are checked as phrases. Matching is case-insensitive.

### 📥 Input

The Actor accepts the following user-facing inputs:

| Input           | Type    | Required | Default / Range               |
| --------------- | ------- | -------: | ----------------------------- |
| `keywords`      | Array   |      Yes | Example keywords are provided |
| `location`      | String  |       No | Empty                         |
| `customDomains` | Array   |       No | `@gmail.com`                  |
| `maxEmails`     | Integer |       No | Default `10`, range `1–10000` |
| `excludeWords`  | Array   |       No | Empty                         |

#### 🔍 `keywords`

A list of terms or search queries used to discover relevant Vimeo results.

This is the only required input.

#### 🌍 `location`

An optional geographic phrase used to narrow the search.

#### 📧 `customDomains`

A list of email-domain suffixes that determines which addresses are targeted.

#### 🎯 `maxEmails`

The maximum target for each keyword and email-domain combination.

#### 🚫 `excludeWords`

Words or phrases used to remove unwanted result descriptions from email extraction.

### 🧾 Input Example

```json
{
  "keywords": [
    "Content Creator",
    "Video Marketer",
    "Fitness Coach"
  ],
  "location": "New York",
  "customDomains": [
    "@gmail.com",
    "@yahoo.com",
    "@outlook.com"
  ],
  "maxEmails": 20,
  "excludeWords": [
    "crypto",
    "onlyfans"
  ]
}
```

### 📤 Output Example

A typical dataset record follows this structure:

```json
{
  "network": "Vimeo.com",
  "keyword": "Content Creator",
  "title": "Example Vimeo Result",
  "description": "Public result description containing contact information...",
  "url": "https://vimeo.com/example",
  "email": "creator@example.com"
}
```

The exact title, description, URL, and email values depend on the publicly indexed search results available for the requested terms.

### 💰 Pricing

The Actor configuration implements a result limitation for free users.

> **💳 Pricing Behavior**
>
> - Free users are limited to a maximum of **100 emails per run** by the Actor.
> - If a free-user request exceeds that limit, the Actor applies the 100-email ceiling.
> - Paid users are not restricted by this Actor-level free-tier ceiling.
> - The configured `maxEmails` value still controls the requested target for each keyword-domain combination.
> - Actual results can be lower than the requested target when relevant public results or matching email addresses are unavailable.

The Actor also stops searching when result pages become unproductive, which means increasing a requested target does not guarantee additional contacts.

### 🧠 Tips and Best Practices

For better **Vimeo Email Scraper** results, use a balanced search strategy rather than simply maximizing every input.

- Use 3–5 closely related keywords for a focused audience.

- Combine role terms and niche terms, such as `Video Producer`, `Marketing Video Producer`, and `Corporate Video Producer`.

- Add multiple appropriate email domains when broader contact coverage is useful.

- Use location only when geographic filtering is important.

- Keep exclusion terms focused so useful prospects are not accidentally filtered.

- Start with a moderate `maxEmails` value and increase it after reviewing result quality.

- Broader searches can take longer, especially when many keyword-domain combinations are supplied.

- The Actor's configured run timeout defaults to 3600 seconds in the supplied input description, so wide searches may require appropriate run-option adjustments.

### ⏱️ Why Did My Vimeo Email Scraper Run Return Fewer Emails?

A lower result count does not necessarily mean the Actor failed.

The scraper can return fewer emails because:

- The requested keyword is too narrow.
- The chosen email domain is uncommon among relevant results.
- The location filter is restrictive.
- Search results do not expose email addresses.
- Duplicate emails were already discovered.
- Later result pages contain few or no new addresses.
- The available public search coverage is smaller than the requested target.

For better coverage, try related keywords, additional email domains, or a broader location.

### ❓ Frequently Asked Questions

#### 🔍 What is Vimeo Email Scraper?

**Vimeo Email Scraper** is an Apify Actor for discovering publicly indexed email addresses associated with Vimeo search results. It organizes each discovered contact with contextual fields such as keyword, title, description, and URL.

#### 📧 Does Vimeo Email Scraper extract Gmail addresses?

Yes. The default email-domain suffix is `@gmail.com`, and additional domains can be supplied through `customDomains`.

#### 🌍 Can I scrape Vimeo emails from a specific country or city?

Yes. Enter the desired country, state, or city in the `location` field to narrow the search.

#### 🎯 Is maxEmails a global limit?

No. In the supplied Actor behavior, `maxEmails` is applied to each keyword + domain combination. Multiple combinations therefore have separate targets.

#### ♻️ Does Vimeo Email Scraper remove duplicate emails?

Yes. The Actor tracks previously collected email addresses and avoids adding the same email more than once during the run.

#### 🚫 Can I exclude certain Vimeo categories?

You can exclude result descriptions containing specified words or phrases with `excludeWords`. This filter operates on the available description text.

#### 📊 What format are the results saved in?

Results are stored as structured records in the Apify Dataset. The dataset can then be used through Apify's standard dataset workflows and export capabilities.

#### 📉 Why are fewer emails returned than my maxEmails setting?

`maxEmails` is a target, not a guarantee. The Actor can only collect matching addresses that are available in the searchable public result descriptions, and it also stops when additional pages become unproductive.

#### 🧩 Can I use Vimeo Email Scraper for lead research?

Yes. Its keyword, location, domain, exclusion, and structured-output controls make it suitable for targeted contact discovery and research workflows based on publicly indexed information.

### 🤝 Support

For customization requests, Actor improvements, or bespoke scraping solutions, contact:

- contact me by email : <alphascraper69@gmail.com>

# Actor input Schema

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

A list of keywords or queries to search for.

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

Optional country, state or city used to narrow the search. Leave it empty to search without a geographic filter.

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

List of custom email domains

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

How many addresses each search keyword + domain suffix combination may collect before the finder moves on to the next one. This is a per-combination target, not a run-wide total: with 3 keyword and 2 Domains and a limit of 20, the run works through all 6 combinations and aims for up to 20 addresses in each, so up to 120 overall. Lower values finish sooner and cost less; higher values dig deeper but never guarantee a fuller result, since the run can only find what is publicly listed.

## `excludeWords` (type: `array`):

Words or phrases you do not want to see.

## Actor input object example

```json
{
  "keywords": [
    "Content Creator",
    "Video Marketer"
  ],
  "location": "New york",
  "customDomains": [
    "@gmail.com"
  ],
  "maxEmails": 10,
  "excludeWords": []
}
```

# 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": [
        "Content Creator",
        "Video Marketer"
    ],
    "location": "New york",
    "customDomains": [
        "@gmail.com"
    ],
    "excludeWords": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("email_scraper/vimeo-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": [
        "Content Creator",
        "Video Marketer",
    ],
    "location": "New york",
    "customDomains": ["@gmail.com"],
    "excludeWords": [],
}

# Run the Actor and wait for it to finish
run = client.actor("email_scraper/vimeo-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": [
    "Content Creator",
    "Video Marketer"
  ],
  "location": "New york",
  "customDomains": [
    "@gmail.com"
  ],
  "excludeWords": []
}' |
apify call email_scraper/vimeo-email-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,email_scraper/vimeo-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/WgMCenbMPtkbZDUAd/builds/9HEiP7lfBuGoFCsSR/openapi.json
