# Instagram Email Scraper (`api-empire/instagram-email-scraper`) Actor

Automate email extraction from Instagram with Instagram Email Scraper. The actor scans profiles and external links to pull available contact emails into structured datasets for CRM enrichment.

- **URL**: https://apify.com/api-empire/instagram-email-scraper.md
- **Developed by:** [API Empire](https://apify.com/api-empire) (community)
- **Categories:** Lead generation, Social media, Automation
- **Stats:** 49 total users, 4 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 3.00 out of 5 stars

## Pricing

$19.99/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/platform/actors/running/actors-in-store#rental-actors

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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 📱

**Instagram** Email Scraper allows users to **extract** valuable **contact** information from **Instagram** profiles and posts. This includes email addresses, usernames, profile URLs, and other publicly available **data** that can be used for lead generation and outreach.

The tool is designed to identify and retrieve email addresses from public profiles, ensuring compliance with **Instagram**'s **data** policies. Additionally, users can gather supplementary **data** such as follower counts and bio descriptions to better understand their target audience.

By using this **Instagram** email **extract**ion tool, businesses can streamline their **data** collection process and focus on building connections with potential clients.

Instagram Email Scraper is a powerful tool designed to extract email addresses from Instagram profiles efficiently and accurately. It enables businesses and marketers to gather contact information for lead generation and outreach purposes.

With the growing importance of Instagram as a marketing platform, email scraping software for Instagram has become essential for connecting with potential clients and collaborators. This tool simplifies the process of finding emails from public profiles and posts.

Instagram contact extractor tools are ideal for businesses seeking to expand their reach by identifying and connecting with relevant audiences. By automating the email harvesting process, users can save time and focus on building meaningful relationships.

### Support and feedback

- **Bug reports**: Open a ticket in the repository Issues section
- **Custom features**: Contact our enterprise support team
  *Email: hello.apiempire@gmail.com*
### Extractable Data Table 📊
| Data Type | Description |
| --- | --- |
| Email addresses | Extract publicly available email addresses from Instagram profiles. |
| Usernames | Retrieve usernames of targeted Instagram profiles for further analysis. |
| Profile URLs | Gather direct links to Instagram profiles for easy access. |
| Follower counts | Extract follower counts to assess the popularity of profiles. |
| Bio descriptions | Retrieve bio information to understand the profile's focus or niche. |
| Post engagement metrics | Collect engagement data such as likes and comments on posts. |
| Profile pictures | Download profile pictures for visual identification. |
| Location data | Extract location tags from profiles or posts if publicly available. |

### Key Features of **Instagram** Email Scraper

Here are the **standout features** that make the **Instagram** Email Scraper a **top-tier tool** for **marketers**, **agencies**, and **researchers**:

- ⭐ Efficiently extract email addresses from public **Instagram** profiles and posts
- ⭐ Retrieve additional profile data such as usernames follower counts and bio descriptions
- ⭐ Support for bulk scraping to process multiple profiles simultaneously
- ⭐ **Advanced** filtering options to target specific niches or demographics
- ⭐ Easy integration with lead generation workflows and CRM systems
- ⭐ Compliance with **Instagram**s data policies to ensure ethical usage
- ⭐ User-friendly interface for seamless operation and data extraction
- ⭐ **High**-speed scraping capabilities to save time and improve productivity
- ⭐ Export data in multiple formats such as CSV or JSON for convenience
- ⭐ **Regular** updates to maintain compatibility with **Instagram**s platform changes

### How to use **Instagram** Email Scraper 🚀

Follow this **simple, step-by-step guide** to start extracting **Instagram** emails today:

1. ✅ **Sign up** or **log in** to your account on the **Instagram** Email Scraper platform
2. ✅ Navigate to the dashboard and select the **Instagram** scraping tool option
3. ✅ Enter the **Instagram** profile URLs or keywords to target specific profiles or niches
4. ✅ Adjust the scraping settings such as filters for follower count or bio keywords
5. ✅ **Start** the scraping process and monitor the progress in real-time on the dashboard
6. ✅ Once the scraping is complete review the extracted data for accuracy
7. ✅ **Export** the data in your preferred format such as CSV or JSON
8. ✅ **Integrate** the data into your lead generation or outreach workflows

### Use Cases 🎯

Lead Generation
🎯 Extract emails from **Instagram** profiles to build a targeted contact list
🎯 **Use** **Instagram** email extraction tools to identify potential clients or collaborators

Market Research
🎯 **Analyze** bio descriptions and follower counts to understand audience demographics
🎯 Harvest data to identify trends and preferences within specific niches

Influencer Outreach
🎯 **Find** contact information for influencers to collaborate on marketing campaigns
🎯 **Use** **Instagram** contact extractor tools to streamline influencer identification

Business Networking
🎯 Connect with professionals and businesses through extracted email addresses
🎯 Utilize **Instagram** email finder tools to expand your professional network

Event Promotion
🎯 Reach out to potential attendees or collaborators using scraped emails
🎯 Leverage **Instagram** lead generation tools for targeted event invitations

### Why choose us? 💎

Our **Instagram** Email Scraper stands out as the **best** **Instagram** email scraper due to its reliability, efficiency, and compliance with ethical guidelines. We prioritize user experience by offering a **user-friendly** interface and **advanced** features that simplify the email scraping process.

Our tool is designed to handle large-scale data extraction while maintaining accuracy and speed. By using our **Instagram** email extraction tool, businesses can save time and focus on building meaningful connections with their target audience.

We continuously update our software to ensure compatibility with **Instagram**'s platform changes, providing users with a seamless experience. Additionally, our customer support team is available to assist with any issues or questions, ensuring a smooth and productive workflow.

Choose our **Instagram** data scraping tool to gain a competitive edge in lead generation and outreach efforts.

### **Instagram** Email Scraper Scalability 📈

Our **Instagram** Email Scraper is designed to handle data extraction tasks of any size, making it suitable for businesses of all scales. Whether you need to extract emails from a few profiles or thousands, our tool ensures high-speed processing without compromising accuracy.

The software supports bulk scraping, allowing users to target multiple profiles simultaneously and save time. Advanced filtering options enable users to focus on specific niches or demographics, ensuring relevant data collection.

By leveraging our **Instagram** email extraction tool, businesses can scale their outreach efforts and achieve their growth objectives **efficient**ly. Regular updates and optimizations ensure the tool remains compatible with **Instagram**'s evolving platform, providing reliable performance at any scale.

### **Instagram** Email Scraper Legal Guidelines ⚖️

**Yes**—scraping **Instagram** is **legal** as long as you follow **ethical** and **compliant** practices. The **Instagram** Email Scraper extracts only **publicly available** information from **public** **Instagram** profiles, making it **safe** and **compliant** for **research**, **marketing**, and **analysis**.

#### Legal & Ethical Guidelines
⚖️ **Ensure** compliance with **Instagram**s terms of service when using the scraper
⚖️ **Only** extract data from public profiles to avoid violating privacy policies
⚖️ **Do not** use the tool for unsolicited email campaigns or spamming activities
⚖️ Respect local data protection laws and regulations when handling extracted data
⚖️ **Obtain** consent from individuals before using their contact information for marketing purposes
⚖️ **Avoid** scraping data from profiles explicitly marked as private or restricted
⚖️ **Use** the **Instagram** email extraction tool responsibly and ethically
⚖️ Regularly review legal updates to ensure continued compliance with data usage laws

### Input Parameters 🧩
📦 Example Input (JSON)
```json
{
  "keywords": ["Instagram Email Scraper"],
  "country": "Global",
  "maxEmailNumbers": 20,
  "platform": "Instagram",
  "engine": "legacy"
}
````

### Input Table

| Data Type | Description |
| --- | --- |
| keywords | Keywords to find relevant profiles |
| country | Country setting (Global) |
| maxEmailNumbers | Maximum emails to collect (default 20) |
| platform | Platform to scrape (Instagram) |
| engine | Engine type (legacy) |
| proxyConfiguration | Optional proxy settings |

### Output Format 📤

📝 Example Output (JSON)

```json
[
  {
    "network": "Instagram",
    "keyword": "Instagram Email Scraper",
    "title": "Google's Single-Benefit Marketing Strategy for Chrome ...",
    "description": "✓For years, once we created a Gmail account, we couldn't change the username (the part before @ gmail.com ). ... Grand Rapids Marketing Co. Read more",
    "url": "https://www.linkedin.com/posts/phill-agnew_heres-how-google-marketed-chrome-browser-activity-7404878510214914048-dLxI",
    "email": "before@gmail.com"
  }
]
```

### Output Table

| Data Type | Description |
| --- | --- |
| network | Identifies Instagram as the source |
| keyword | Keyword that triggered the result (Instagram Email Scraper) |
| title | Profile title or username |
| description | Public bio snippet with contact info |
| url | Direct Instagram profile link |
| email | Extracted email address |

### FAQ ❓

#### What is **Instagram** **Email Scraper**?

Instagram Email Scraper is a tool designed to extract email addresses and other data from public Instagram profiles and posts.

#### Is the scraper compliant with **Instagram**'s terms of service?

**Yes**, the tool is designed to comply with Instagram's data policies by only extracting **publicly available** information.

#### Can I scrape data from **private** profiles?

**No**, the scraper only extracts data from public profiles to ensure **compliance** with privacy guidelines.

#### What data formats are supported for **export**?

You can export data in formats such as **CSV** or **JSON** for easy integration into your workflows.

#### Is the tool suitable for **large-scale** data **extract**ion?

**Yes**, the Instagram Email Scraper supports bulk scraping and is optimized for high-speed processing.

#### How do I ensure ethical usage of the **extract**ed data?

Use the data responsibly, avoid spamming, and obtain consent before contacting individuals for marketing purposes.

#### Can I filter profiles based on **specific** criteria?

**Yes**, the tool offers advanced **filtering** options to target profiles based on follower counts, bio keywords, and more.

#### Does the scraper work with the latest **Instagram** updates?

The tool is regularly updated to ensure compatibility with Instagram's evolving platform.

#### What support is available if I encounter issues?

Our customer support team is available to assist with any questions or technical difficulties.

#### Is the tool beginner-friendly?

**Yes**, the **user-friendly** interface makes it easy for beginners to navigate and use the scraper effectively.

#### Can I use the scraper for influencer outreach?

**Yes**, the tool is ideal for finding contact information for influencers to collaborate on marketing campaigns.

#### What are the **legal** guidelines for using the scraper?

Ensure **compliance** with Instagram's terms of service, respect privacy policies, and follow local data protection laws.

#### How often is the tool updated?

The scraper is updated regularly to maintain compatibility with Instagram and improve performance.

#### Can I scrape location data from profiles?

**Yes**, the tool can extract **publicly available** location tags from profiles or posts, if accessible.

#### Is there a **limit** to the number of profiles I can scrape?

The tool supports scalable data extraction, allowing users to scrape as many profiles as needed within their plan limits.

### What are other Instagram scraping tools?

If you want to scrape specific Instagram data, you can use any of the dedicated scrapers below for faster and more targeted results.

| Scraper Name | Scraper Name |
|---|---|
| [Instagram B2b Email Scraper](https://apify.com/api-empire/instagram-b2b-email-scraper) | [Instagram Posts Scraper](https://apify.com/api-empire/instagram-posts-scraper) |
| [Instagram B2b Lead Scraper](https://apify.com/api-empire/instagram-b2b-lead-scraper) | [Instagram Profile Email Scraper](https://apify.com/api-empire/instagram-profile-email-scraper) |
| [Instagram B2b Phone Number Scraper](https://apify.com/api-empire/instagram-b2b-phone-number-scraper) | [Instagram Profile Email Scraper By Keyword](https://apify.com/api-empire/instagram-profile-email-scraper-by-keyword) |
| [Instagram Comments Scraper](https://apify.com/api-empire/instagram-comments-scraper) | [Instagram Profile Lead Scraper](https://apify.com/api-empire/instagram-profile-lead-scraper) |
| [Instagram Dm Automation](https://apify.com/api-empire/instagram-dm-automation) | [Instagram Profile Lead Scraper By Keyword](https://apify.com/api-empire/instagram-profile-lead-scraper-by-keyword) |
| [Instagram Followers And Following Scrapper](https://apify.com/api-empire/instagram-followers-and-following-scrapper) | [Instagram Profile Phone Number Scraper](https://apify.com/api-empire/instagram-profile-phone-number-scraper) |
| [Instagram Followers Count Scraper](https://apify.com/api-empire/instagram-followers-count-scraper) | [Instagram Profile Phone Number Scraper By Keyword](https://apify.com/api-empire/instagram-profile-phone-number-scraper-by-keyword) |
| [Instagram Followers Scraper](https://apify.com/api-empire/instagram-followers-scraper) | [Instagram Profile Post Scraper](https://apify.com/api-empire/instagram-profile-post-scraper) |
| [Instagram Following Scraper](https://apify.com/api-empire/instagram-following-scraper) | [Instagram Profile Reels Scraper](https://apify.com/api-empire/instagram-profile-reels-scraper) |
| [Instagram Hashtag Scraper](https://apify.com/api-empire/instagram-hashtag-scraper) | [Instagram Profile Scraper](https://apify.com/api-empire/instagram-profile-scraper) |
| [Instagram Hashtag Username Scraper](https://apify.com/api-empire/instagram-hashtag-username-scraper) | [Instagram Reels Scraper](https://apify.com/api-empire/instagram-reels-scraper) |
| [Instagram Highlights Scraper](https://apify.com/api-empire/instagram-highlights-scraper) | [Instagram Related Hashtag Stats Scraper](https://apify.com/api-empire/instagram-related-hashtag-stats-scraper) |
| [Instagram Lead Scraper](https://apify.com/api-empire/instagram-lead-scraper) | [Instagram Related Person Scraper](https://apify.com/api-empire/instagram-related-person-scraper) |
| [Instagram Likes Scraper](https://apify.com/api-empire/instagram-likes-scraper) | [Instagram Single Reels Scraper](https://apify.com/api-empire/instagram-single-reels-scraper) |
| [Instagram Location Scraper](https://apify.com/api-empire/instagram-location-scraper) | [Instagram Story Details Scraper](https://apify.com/api-empire/instagram-story-details-scraper) |
| [Instagram Mentions Scraper](https://apify.com/api-empire/instagram-mentions-scraper) | [Instagram Tagged Mentions Posts Scraper](https://apify.com/api-empire/instagram-tagged-mentions-posts-scraper) |
| [Instagram Phone Number Scraper](https://apify.com/api-empire/instagram-phone-number-scraper) | [Instagram Tagged Posts Scraper](https://apify.com/api-empire/instagram-tagged-posts-scraper) |
| [Instagram Post Details Scraper](https://apify.com/api-empire/instagram-post-details-scraper) |  |

# Actor input Schema

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

Search terms to find Instagram content (e.g. marketing, founder, business). We search Google for profiles & posts matching these and extract emails.

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

Social platform to scrape. Instagram is supported.

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

Narrow results by place (e.g. London, New York). Leave blank for worldwide.

## `emailDomains` (type: `array`):

Only keep emails from these domains (e.g. @gmail.com, @outlook.com). Empty = all domains.

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

Cap how many emails we collect per keyword (1–5000). Default: 20.

## `engine` (type: `string`):

🛡️ Legacy — GOOGLE\_SERP proxy, proven & reliable (slower, higher cost). More options coming soon.

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

Proxy to use for requests. Default: none. On block, we auto-fallback: datacenter → residential (3 retries).

## Actor input object example

```json
{
  "keywords": [
    "marketing"
  ],
  "platform": "Instagram",
  "location": "",
  "emailDomains": [
    "@gmail.com"
  ],
  "maxEmails": 20,
  "engine": "legacy",
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# 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": [
        "marketing"
    ],
    "emailDomains": [
        "@gmail.com"
    ],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("api-empire/instagram-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": ["marketing"],
    "emailDomains": ["@gmail.com"],
    "proxyConfiguration": { "useApifyProxy": False },
}

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

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).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": [
    "marketing"
  ],
  "emailDomains": [
    "@gmail.com"
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call api-empire/instagram-email-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=api-empire/instagram-email-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Instagram Email Scraper",
        "description": "Automate email extraction from Instagram with Instagram Email Scraper. The actor scans profiles and external links to pull available contact emails into structured datasets for CRM enrichment.",
        "version": "0.1",
        "x-build-id": "uCEX5VKLgaYmkLcSx"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/api-empire~instagram-email-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-api-empire-instagram-email-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/api-empire~instagram-email-scraper/runs": {
            "post": {
                "operationId": "runs-sync-api-empire-instagram-email-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/api-empire~instagram-email-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-api-empire-instagram-email-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "keywords"
                ],
                "properties": {
                    "keywords": {
                        "title": "🔑 Keywords",
                        "type": "array",
                        "description": "Search terms to find Instagram content (e.g. marketing, founder, business). We search Google for profiles & posts matching these and extract emails.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "platform": {
                        "title": "📱 Platform",
                        "enum": [
                            "Instagram"
                        ],
                        "type": "string",
                        "description": "Social platform to scrape. Instagram is supported.",
                        "default": "Instagram"
                    },
                    "location": {
                        "title": "📍 Location",
                        "type": "string",
                        "description": "Narrow results by place (e.g. London, New York). Leave blank for worldwide.",
                        "default": ""
                    },
                    "emailDomains": {
                        "title": "📧 Email Domains",
                        "type": "array",
                        "description": "Only keep emails from these domains (e.g. @gmail.com, @outlook.com). Empty = all domains.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxEmails": {
                        "title": "🎯 Max Emails per Keyword",
                        "minimum": 1,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "Cap how many emails we collect per keyword (1–5000). Default: 20.",
                        "default": 20
                    },
                    "engine": {
                        "title": "⚡ Engine",
                        "enum": [
                            "legacy"
                        ],
                        "type": "string",
                        "description": "🛡️ Legacy — GOOGLE_SERP proxy, proven & reliable (slower, higher cost). More options coming soon.",
                        "default": "legacy"
                    },
                    "proxyConfiguration": {
                        "title": "🌐 Proxy",
                        "type": "object",
                        "description": "Proxy to use for requests. Default: none. On block, we auto-fallback: datacenter → residential (3 retries)."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```