# Tumblr Email Scraper (`email_scraper/tumblr-email-scraper`) Actor Tumblr Email Scraper extracts publicly indexed email addresses from Tumblr-related search results using keywords, locations, and custom email domains. Build targeted contact lists with structured emails, titles, descriptions, and URLs for lead generation and research. - **URL**: https://apify.com/email\_scraper/tumblr-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 ### Tumblr Email Scraper – Overview **Tumblr Email Scraper** is an Apify Actor designed to discover publicly listed email addresses associated with Tumblr pages by searching for relevant keywords, optional locations, and selected email domains. It turns targeted search terms such as `skincare`, `cosmetics`, `manager`, or `founder` into structured Tumblr contact leads. The Actor is useful for lead generation, creator discovery, outreach research, market research, audience building, and contact-list development where publicly indexed Tumblr information is relevant. Instead of manually searching Tumblr-related pages one by one, you provide a list of keywords and let the **Tumblr Email Scraper** collect matching search results and extract email addresses that appear publicly in those results. > **💡 Best results:** Use several specific keyword variations rather than one broad keyword. For example, `Fitness Coach`, `Fitness Trainer`, `Fitness Influencer`, and `Online Fitness Coach` can provide more targeted coverage than only `Fitness`. The Actor produces structured dataset records containing the search keyword, result title, description, URL, and discovered email address. Results are de-duplicated so the same email is not repeatedly added to the dataset during a run. ### Tumblr Email Scraper – Key Features The **Tumblr Email Scraper** focuses on targeted email discovery from publicly indexed Tumblr-related search results. > **✨ Key Features** > > - Search Tumblr content using multiple keywords or queries > - Narrow searches with an optional country, state, or city > - Search for selected email domain suffixes > - Extract publicly visible email addresses from search result descriptions > - Exclude results containing unwanted words or phrases > - Remove duplicate email addresses > - Set a configurable email target from 1 to 10,000 > - Process every keyword and email-domain combination > - Store extracted records in an Apify dataset > - Preserve structured lead information including title, description, URL, and keyword > - Resume progress after interruptions within the Actor run state The Actor is built for users who want a practical **Tumblr email scraper** workflow without manually collecting contact details from individual search results. #### Why Use Tumblr Email Scraper? Finding relevant Tumblr contacts manually can become repetitive when you need to investigate multiple niches, job roles, locations, or email providers. The **Tumblr Email Scraper** provides a structured approach: define what you are looking for, choose the email domains that matter, optionally add a geographic filter, and let the Actor process the search combinations. > **🎯 Why use it?** > Use targeted keywords to discover potentially relevant Tumblr contacts, collect associated public email addresses, and organize the resulting lead information in a structured dataset for further research or outreach workflows. The quality of results depends on what information is publicly indexed. The Actor does not guarantee that every Tumblr profile has an email address, that every keyword produces results, or that a requested target will always be reached. ### Tumblr Email Scraper – What Data You Can Extract The **Tumblr Email Scraper** returns structured records based on matching search results. Each record contains the information available from the corresponding result. | Field | Description | | ------------- | --------------------------------------------------------------------- | | `network` | Identifies the source network as Tumblr.com | | `keyword` | Keyword used for the search | | `title` | Title of the matching search result | | `description` | Search result description containing the publicly indexed information | | `url` | URL associated with the result | | `email` | Email address extracted from the result description | > **📦 Output:** The primary contact field is `email`, while `keyword`, `title`, `description`, and `url` provide context for understanding where the email was discovered. This structure makes the **Tumblr Email Scraper** useful when a raw email list is not enough and you also need source context for each discovered contact. #### How Email Extraction Works The Actor searches for pages matching the specified keyword and email-domain suffix. It then analyzes the available result descriptions and extracts email addresses matching the selected domain patterns. For example, a domain filter such as `@gmail.com` focuses extraction on addresses ending with that suffix. The Actor can also work with custom domains such as company-specific domains, allowing users to research both common email providers and organization-related addresses. Only email addresses that are publicly present in the indexed result information can be extracted. Private contact information is not added simply because it may exist elsewhere. ### Tumblr Email Scraper – How to Use It Using the **Tumblr Email Scraper** requires only a few input decisions. #### Step 1: Add Keywords Enter one or more keywords that describe the people, businesses, topics, or roles you want to discover. Examples: ```text skincare cosmetics beauty blogger fitness coach marketing manager founder photographer fashion designer ``` Specific combinations generally provide more targeted search intent than extremely broad terms. #### Step 2: Add a Location The optional location field can contain a country, state, or city. Examples: ```text New York United States London Toronto California ``` Leave the location empty when you want broader coverage without a geographic filter. #### Step 3: Select Email Domains Add the email suffixes you want the Actor to search for. Example: ```text @gmail.com @yahoo.com @outlook.com @hotmail.com @icloud.com ``` You can also provide organization-specific domains where relevant. #### Step 4: Set the Maximum Emails The `maxEmails` input accepts values from **1 to 10,000**. The limit applies to each keyword + domain combination processed by the Actor. For example, three keywords and two email domains create six combinations. > **⚠️ Important:** `maxEmails` is a per-combination target, not a simple run-wide target. Actual output can be lower because search availability, duplicate emails, filtering, and other stopping conditions affect the final number of unique records. #### Step 5: Configure Exclusions Use `excludeWords` to remove search results containing specific unwanted words or phrases. For example: ```text crypto onlyfans adult ``` If a result description contains an excluded term, that result is skipped for email extraction. ### How to Scrape Tumblr Emails for a Specific Niche A strong **Tumblr email scraper** strategy starts with intent-rich search terms. Suppose you want contacts related to skincare. Instead of using only: ```text skincare ``` try: ```text skincare blogger skincare creator beauty influencer cosmetics founder beauty entrepreneur skincare consultant ``` You can then combine those terms with selected domains and, when appropriate, a location. > **💡 Search tip:** Broader keyword coverage can increase discovery opportunities. When results are sparse, add related terms, job titles, descriptive phrases, or remove an overly restrictive location. This approach is especially useful for niche research, creator discovery, marketing research, and targeted lead generation. ### Can You Filter Tumblr Email Searches by Location? Yes. The **Tumblr Email Scraper** supports an optional location input. A location can be a country, state, or city. The location is used to narrow the search query, helping users focus on a geographic market. For example: ```text Keywords: fitness coach fitness trainer gym owner Location: New York ``` Location filtering is optional. For broader discovery, leave the location field empty. Keep in mind that geographic targeting depends on publicly indexed search information. A location filter does not guarantee that every returned profile is physically located in that area. ### Can You Search for Specific Email Domains? Yes. The **Tumblr Email Scraper** supports a list of custom email domain suffixes. This allows searches such as: ```text @gmail.com @yahoo.com @outlook.com @example.com ``` You can use common consumer email providers or company-specific domains. > **📌 Domain strategy:** Combining several relevant domains can expand coverage, but every additional keyword/domain combination increases the amount of search work required. Use domains that match your actual research objective. ### Input The Actor accepts the following user-facing inputs: | Input | Type | Required | Purpose | | --------------- | ---------------- | -------: | ---------------------------------------------------------------------- | | `keywords` | Array of strings | Yes | Keywords or search queries used to discover relevant Tumblr results | | `location` | String | No | Optional geographic filter such as a country, state, or city | | `customDomains` | Array of strings | No | Email domain suffixes to search for | | `maxEmails` | Integer | No | Target number of emails for each keyword + domain combination | | `excludeWords` | Array of strings | No | Words or phrases that cause matching result descriptions to be skipped | Example input: ```json { "keywords": [ "skincare", "beauty blogger", "cosmetics founder" ], "location": "New York", "customDomains": [ "@gmail.com", "@outlook.com" ], "maxEmails": 20, "excludeWords": [ "crypto", "onlyfans" ] } ``` The `keywords` input is the only required field. Other fields can be adjusted according to the desired search strategy. ### Output The **Tumblr Email Scraper** stores extracted records in the Apify dataset. Example output structure: ```json { "network": "Tumblr.com", "keyword": "skincare", "title": "Example Tumblr Result", "description": "Publicly indexed result information...", "url": "https://example.com/", "email": "contact@example.com" } ``` The exact title, description, URL, and email depend on the publicly indexed result discovered during the run. > **📊 Structured Dataset:** Each record keeps the email together with search context, making the output easier to review, filter, and use for downstream research. ### Use Cases The **Tumblr Email Scraper** can support a variety of research and lead-discovery workflows. #### Lead Generation Discover publicly indexed contact emails associated with relevant Tumblr search results. Combine niche keywords, professional terms, and email domains to build targeted research lists. #### Creator and Influencer Research Search for terms such as: ```text beauty creator fashion blogger fitness influencer photographer artist ``` This can help identify publicly indexed Tumblr contacts for creator research and partnership discovery. #### B2B Prospect Research Use business-related terms such as: ```text founder manager agency owner marketing director consultant ``` Company-specific email domains can be included when appropriate. #### Market Research Explore how different keywords perform across public Tumblr-related search results. Compare niches, regions, roles, or audience segments using structured dataset records. #### Outreach Research The **Tumblr Email Scraper** can provide publicly indexed email addresses for legitimate, consent-aware business or research workflows. Users should always follow applicable privacy, anti-spam, and communication laws when contacting people. > **⚖️ Responsible use:** The Actor only targets publicly indexed information. Users are responsible for how collected contact data is processed, stored, and used. ### Pricing The provided Actor code contains plan-aware result handling. For free users, the Actor limits the effective `maxEmails` value to **100**. Since the scraper processes keyword + domain combinations independently, the overall number of unique records can vary based on the number of combinations and duplicate overlap. For paying users, the free-tier 100-email ceiling is not applied, while the Actor input still accepts `maxEmails` only within its configured range of **1–10,000**. > **💰 Pricing note:** The provided files do not define a monetary price per result, per email, or per run. Therefore, no invented dollar amount is stated here. Actual Apify platform usage costs may depend on the applicable Actor and platform configuration. ### Tips and Best Practices #### Use Specific Keywords Specific phrases can produce more targeted discovery than generic one-word queries. For example: ```text fitness coach online fitness coach fitness trainer personal trainer ``` can be more useful than only `fitness`. #### Combine Multiple Search Terms Use related keywords to expand semantic coverage across your target niche. A useful pattern is: ```text Topic + Role Topic + Profession Topic + Business Type Topic + Creator ``` #### Use Location Selectively Location can improve targeting for regional research, but an overly narrow geographic filter may reduce available results. When results are sparse, test the search without a location. #### Test Multiple Email Domains Using only one domain can limit discovery. Consider common providers and relevant organization domains when appropriate. #### Use Exclusions Carefully Exclude terms that are genuinely irrelevant to your project. Overly broad exclusions may remove useful results along with unwanted ones. #### Allow More Time for Wide Searches Large keyword/domain combinations can require many search-result pages. The Actor may take longer when processing broad searches or high email targets. > **⏱️ Important:** Actual run duration depends on the number of keywords, domains, available indexed results, filtering, and stopping conditions. A larger target does not guarantee a proportional increase in discovered emails. ### Frequently Asked Questions #### What is Tumblr Email Scraper? Tumblr Email Scraper is an Apify Actor that searches for publicly indexed Tumblr-related results using keywords and selected email domains, then extracts matching email addresses and stores them with source context. #### How does Tumblr Email Scraper find email addresses? The Actor searches indexed web results for Tumblr-related pages matching the selected keywords, location, and email-domain suffix. Matching email addresses found in result descriptions are extracted into structured records. #### Can Tumblr Email Scraper scrape any email address on Tumblr? No. The Actor extracts email addresses that are publicly present in the indexed result information it processes. It does not guarantee discovery of private, hidden, or non-indexed contact details. #### Can I use multiple keywords with Tumblr Email Scraper? Yes. The `keywords` input accepts an array, allowing multiple topics, professions, roles, or search phrases in one run. #### Can I search Tumblr emails by country or city? Yes. The optional `location` field accepts a country, state, or city and can narrow the search geographically. #### Can I search for Gmail addresses from Tumblr? Yes. Add `@gmail.com` to `customDomains`. Other domain suffixes can also be supplied. #### Can I search for company email addresses? Yes. You can include organization-specific email suffixes in `customDomains`, provided those addresses are publicly indexed in the information being searched. #### Does Tumblr Email Scraper remove duplicate emails? Yes. The Actor tracks discovered email addresses and avoids repeatedly adding the same email address during the run. #### What happens when I use exclude words? When an excluded word or phrase appears in a result description, the entire matching result is skipped for email extraction. #### Why did Tumblr Email Scraper return fewer emails than my target? A target is not a guarantee. The number of available indexed results, duplicate addresses, excluded results, selected domains, location filtering, and search-result availability can all reduce the final output. #### Is `maxEmails` a run-wide limit? No. The configured target is processed independently for each keyword + domain combination. The overall number of records therefore depends on how many combinations you submit and how much unique data they produce. #### What data does Tumblr Email Scraper return? The dataset includes `network`, `keyword`, `title`, `description`, `url`, and `email`. #### Can I leave the location empty? Yes. Leaving `location` empty removes the geographic filter and allows broader searches. #### What are good keywords for Tumblr email scraping? Good keywords are specific phrases related to your goal, such as `beauty blogger`, `fitness coach`, `marketing manager`, `photographer`, or `fashion designer`. Combining related terms usually gives broader research coverage than relying on one generic keyword. #### Can I use Tumblr Email Scraper for lead generation? Yes, it can support lead-discovery and research workflows where publicly indexed contact information is relevant. You remain responsible for complying with applicable privacy and outreach requirements. #### Does more `maxEmails` always mean more emails? No. Increasing the target gives the Actor permission to search more deeply, but actual results depend on the amount of relevant public information available. ### Support For questions, adjustments, or a bespoke Actor requirement, use the contact information provided with the Actor. > **💬 Need a tweak or a bespoke build?** Contact ****. The **Tumblr Email Scraper** is most effective when its keywords, domains, location, and exclusions are aligned with a clearly defined research objective. Start with a small, focused search, review the dataset, and then broaden the strategy with additional related keywords or domains when more coverage is needed. # 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": [ "skincare", "cosmetics", "manager", "founder" ], "location": "New york", "customDomains": [ "@gmail.com" ], "maxEmails": 5, "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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keywords": [ "skincare", "cosmetics", "manager", "founder" ], "location": "New york", "customDomains": [ "@gmail.com" ], "excludeWords": [] }; // Run the Actor and wait for it to finish const run = await client.actor("email_scraper/tumblr-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keywords": [ "skincare", "cosmetics", "manager", "founder", ], "location": "New york", "customDomains": ["@gmail.com"], "excludeWords": [], } # Run the Actor and wait for it to finish run = client.actor("email_scraper/tumblr-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": [ "skincare", "cosmetics", "manager", "founder" ], "location": "New york", "customDomains": [ "@gmail.com" ], "excludeWords": [] }' | apify call email_scraper/tumblr-email-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,email_scraper/tumblr-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 ` 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/FQxHj2J0rbIo5Rafm/builds/hbmbXO8StTjbBX8kd/openapi.json