# Goodreads Email Scraper (`scraper-mind/goodreads-email-scraper`) Actor

GoodReads Email Scraper – Effortlessly scrape GoodReads emails by keywords & location for outreach, marketing & research! Fast, accurate & proxy-enabled for seamless scraping. 📊 Export data in JSON, CSV, Excel. Perfect for authors, marketers & researchers!

- **URL**: https://apify.com/scraper-mind/goodreads-email-scraper.md
- **Developed by:** [Scraper Mind](https://apify.com/scraper-mind) (community)
- **Categories:** Lead generation, Automation, Other
- **Stats:** 41 total users, 0 monthly users, 100.0% runs succeeded, 4 bookmarks
- **User rating**: No ratings yet

## Pricing

$5.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period. You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#rental-actors

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

### 📸 Instagram Email Scraper – Targeted, Scalable & Cost-Effective

The **Instagram Email Scraper** is a powerful Actor that extracts email addresses from Instagram profiles based on custom keywords and optional location filtering. Perfect for influencer marketing, lead generation, and market research, this tool is 50% more affordable than alternatives while offering precise and scalable results.

***

### 🌟 Key Features

| Feature                        | Description                                                                                       |
|-------------------------------|---------------------------------------------------------------------------------------------------|
| 🔍 **Multi-Keyword Search**   | Search Instagram profiles using multiple keywords to target specific audiences and niches.        |
| 📍 **Location Filtering**     | Narrow your search by geographic location to find local influencers and businesses.               |
| 📧 **Custom Email Domains**   | Filter emails by domain (e.g., `@gmail.com`, `@yahoo.com`) for more targeted outreach.             |
| 🔗 **Direct Profile Links**   | Instantly access Instagram profiles via direct URLs for quicker engagement.                       |
| ⚡ **Fast & Scalable**        | Easily scrape small or large volumes. Use proxies to scale operations without getting blocked.     |
| 🔄 **Automatic Pagination**   | Efficiently handles large datasets with built-in pagination support.                              |
| 🔐 **Proxy Support**          | Supports Datacenter, Residential, and Special proxies for high-volume extraction tasks.           |

***

### 📥 Input

The scraper accepts the following JSON structure as input:

```json
{
  "customDomains": ["@gmail.com"],
  "keywords": ["marketing", "beauty"],
  "location": "new york",
  "platform": "Instagram",
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

#### 🔧 Input Fields

| Field               | Type      | Required | Description                                                                 |
|--------------------|-----------|----------|-----------------------------------------------------------------------------|
| `keywords`         | `array`   | ✅ Yes   | List of keywords to search Instagram profiles with.                         |
| `location`         | `string`  | ❌ No    | Optional location filter to target results by geography.                    |
| `platform`         | `string`  | ❌ No    | Currently only supports `"Instagram"` as the platform.                     |
| `customDomains`    | `array`   | ❌ No    | List of email domains to filter results (e.g., `@gmail.com`).               |
| `proxyConfiguration` | `object` | ❌ No    | Configure proxy usage for reliable and large-scale scraping operations.     |

***

### 📤 Output

The output is a JSON array containing metadata and emails extracted from Instagram profiles. Example:

```json
[
  {
    "keyword": "marketing",
    "title": "Marketing Agency (@primepixelit)",
    "description": "@primepixelit @infotanvir primepixelit@gmail.com infotanvir.it@gmail.com ...",
    "url": "https://www.instagram.com/primepixelit/",
    "email": "primepixelit@gmail.com"
  },
  {
    "keyword": "marketing",
    "title": "Marketing Agency (@primepixelit)",
    "description": "...",
    "url": "https://www.instagram.com/primepixelit/",
    "email": "infotanvir.it@gmail.com"
  }
]
```

#### 🧾 Output Fields

| Field        | Description                                                                 |
|--------------|-----------------------------------------------------------------------------|
| `keyword`    | The keyword used to find the Instagram profile.                             |
| `title`      | Instagram profile name or handle.                                           |
| `description`| Bio or snippet of content pulled from the profile.                          |
| `url`        | Direct URL to the Instagram profile.                                        |
| `email`      | Extracted email address from the bio or profile description.                |

***

### 💻 How to Use

1. **Define Keywords & Filters**\
   Provide one or more keywords, along with optional location and custom domain filters.

2. **Configure Proxies (Optional but Recommended)**\
   Use Apify proxies or your own configuration for high-volume and stable scraping.

3. **Run the Actor**\
   The Actor will search Instagram using the given parameters and extract relevant email data.

4. **Export & Use the Data**\
   Download the scraped data in formats like JSON, CSV, or Excel to use in outreach or research.

***

### 💡 Best Use Cases

- 🎯 **Influencer Marketing**: Discover influencers in specific niches and locations.
- 📣 **Cold Email Campaigns**: Build segmented email lists from Instagram profiles.
- 🕵️ **Competitive Research**: Analyze active Instagram profiles in your industry or region.
- 🤝 **Partnership Outreach**: Find potential collaborators and business leads.

***

### Related Scrapers

Check out these other scrapers that make it easy to collect emails, phone numbers, and content from popular platforms.

- [Linkedin Email Scraper](https://apify.com/scraper-mind/linkedin-email-scraper)
- [Instagram Email Scraper](https://apify.com/scraper-mind/instagram-email-scraper)
- [Instagram Profile Email Scraper](https://apify.com/scraper-mind/instagram-profile-email-scraper)
- [Tiktok Email Scraper](https://apify.com/scraper-mind/tiktok-email-scraper)
- [Linkedin Phone Number Scraper](https://apify.com/scraper-mind/linkedin-phone-number-scraper)
- [Instagram Video Downloader](https://apify.com/scraper-mind/instagram-video-downloader)
- [Telegram Phone Number Scraper](https://apify.com/scraper-mind/telegram-phone-number-scraper)
- [Instagram Phone Number Scraper](https://apify.com/scraper-mind/instagram-phone-number-scraper)
- [Tiktok Profile Email Scraper](https://apify.com/scraper-mind/tiktok-profile-email-scraper)
- [Etsy Email Scraper](https://apify.com/scraper-mind/etsy-email-scraper)
- [Zillow Email Scraper](https://apify.com/scraper-mind/zillow-email-scraper)
- [Youtube Email Scraper](https://apify.com/scraper-mind/youtube-email-scraper)
- [Threads Email Scraper](https://apify.com/scraper-mind/threads-email-scraper)
- [Twitter Email Scraper](https://apify.com/scraper-mind/twitter-email-scraper)

### 🆘 Support & Feedback

💬 For bugs, issues, or feature requests, please open a ticket in the **Issues** section of the repository.

📩 Need a custom solution or enterprise features? Reach out to us at <scrapermindapi@gmail.com>.

### Disclaimer

The data gathered by these scrapers is obtained solely from **publicly accessible sources**. No information is collected from private accounts or content behind passwords. Users are fully responsible for complying with all applicable laws, including spam, privacy, and data protection regulations. Please ensure that you follow each website’s terms of service and adhere to platform rate limits when using these tools.

For data removal requests, contact **<scrapermindapi@gmail.com>**. Use these scrapers responsibly, ethically, and only for legitimate research or business purposes.

# Actor input Schema

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

A list of keywords to search for.

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

Location to filter search results.

## `platform` (type: `string`):

Select platform.

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

List of custom email domains

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

## `perKeywordMaxContacts` (type: `boolean`):

ON (default): "Max Emails" is a target for EACH keyword, so the scraper keeps going through every keyword instead of stopping as soon as the first one fills up. OFF: "Max Emails" is a single total for the whole run. ⚠️ Heads-up: with this ON the run can collect (and be billed for) Max Emails × number of keywords, and takes proportionally longer.

## `perEmailExtensionMaxContacts` (type: `boolean`):

ON (default): "Max Emails" is a target for EACH custom email domain, so the scraper works through every extension instead of stopping once the first one fills up. OFF: extensions share one budget. ⚠️ Heads-up: with this ON the run can collect (and be billed for) Max Emails × number of email extensions, and takes proportionally longer.

## `proxyConfiguration` (type: `object`):

Configure proxies for this Actor.

## Actor input object example

```json
{
  "keywords": [
    "founder",
    "marketing"
  ],
  "location": "",
  "platform": "Goodreads",
  "customDomains": [
    "@gmail.com"
  ],
  "maxEmails": 20,
  "perKeywordMaxContacts": true,
  "perEmailExtensionMaxContacts": true
}
```

# Actor output Schema

## `results` (type: `string`):

Records produced by Goodreads Email Scraper, stored in the run's default dataset.

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

// Run the Actor and wait for it to finish
const run = await client.actor("scraper-mind/goodreads-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": [
        "founder",
        "marketing",
    ],
    "location": "",
    "customDomains": ["@gmail.com"],
}

# Run the Actor and wait for it to finish
run = client.actor("scraper-mind/goodreads-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": [
    "founder",
    "marketing"
  ],
  "location": "",
  "customDomains": [
    "@gmail.com"
  ]
}' |
apify call scraper-mind/goodreads-email-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scraper-mind/goodreads-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/CXNkjJgTF9ZG4ESNs/builds/datTAUBrfEFKBR2lB/openapi.json