{
  "openapi": "3.0.1",
  "info": {
    "title": "YouTube Channel Email Scraper — Emails, Phones & Socials",
    "description": "Find YouTube creator emails in bulk: search a niche for hundreds of channels, filter by subscribers, country and activity, stop at N emails. Checks About, Linktree and websites, verifies emails. Pay only per email found. API and MCP ready.",
    "version": "1.9",
    "x-build-id": "lB5ioa5QbEBi75CSK"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~youtube-channel-email-extractor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-youtube-channel-email-extractor",
        "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/khadinakbar~youtube-channel-email-extractor/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-youtube-channel-email-extractor",
        "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/khadinakbar~youtube-channel-email-extractor/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-youtube-channel-email-extractor",
        "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",
        "properties": {
          "channelUrls": {
            "title": "YouTube channel URLs",
            "type": "array",
            "description": "Use this when the user names specific YouTube channels. Accepts @handles, channel URLs (/@name, /channel/UC..., /c/, /user/), bare channel IDs, or video/Shorts URLs (the video's channel is used). One channel per line. Combine with searchQueries if needed.",
            "items": {
              "type": "string"
            }
          },
          "searchQueries": {
            "title": "Search by niche or keyword (auto-discover channels)",
            "type": "array",
            "description": "Use this when the user describes a niche instead of naming channels (e.g. 'fitness coach', 'tech reviewer', 'real estate investing'). The Actor pages through YouTube search (channel results plus the channels behind matching videos) so one keyword can yield hundreds of channels. Several queries are mixed in turn. Combine with maxEmails to stop once you have enough emails.",
            "items": {
              "type": "string"
            }
          },
          "nichePreset": {
            "title": "Niche picker (optional)",
            "enum": [
              "none",
              "fitness",
              "gaming",
              "beauty",
              "tech",
              "finance",
              "cooking",
              "travel",
              "education",
              "parenting",
              "diy",
              "cars",
              "pets",
              "business",
              "realestate",
              "photography",
              "music",
              "fashion",
              "health",
              "productivity",
              "crypto",
              "programming",
              "art",
              "sports",
              "comedy"
            ],
            "type": "string",
            "description": "Pick a ready-made niche and the Actor searches 3 proven keywords for it. Works together with your own keywords. Leave on \"No preset\" to use only your keywords.",
            "default": "none"
          },
          "similarToChannels": {
            "title": "Find creators similar to these channels",
            "type": "array",
            "description": "Give one or more channels you like (URL or @handle). The Actor finds lookalike creators: channels YouTube recommends next to their latest videos, ranked by how often they show up. Works alone or together with keywords.",
            "items": {
              "type": "string"
            }
          },
          "searchCountry": {
            "title": "Search country",
            "pattern": "^[A-Za-z]{2}$",
            "type": "string",
            "description": "Two-letter country code that YouTube search results are tailored to (e.g. US, GB, IN, DE). Default US. Only affects searchQueries."
          },
          "expandSearch": {
            "title": "Expand search with related keywords",
            "type": "boolean",
            "description": "When a keyword runs out of YouTube results, keep going with related YouTube autocomplete keywords (e.g. \"fitness coach\" -> \"fitness coach for women\"). Lets one keyword reach hundreds of channels. Turn off to stay strictly on the exact keyword.",
            "default": true
          },
          "maxResults": {
            "title": "Maximum channels to check",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Upper limit on channels checked across all inputs. Channels without an email are still saved (free) unless onlyWithEmail is on. Channels removed by the subscriber filter do not count. If empty: 10 x maxEmails when maxEmails is set, otherwise 100. Use 20-60 for a quick test and 500-5000 for bulk lists."
          },
          "maxEmails": {
            "title": "Stop after this many emails",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Stop the run once this many channels with a public email have been saved. This is what you pay for ($0.05 Channel Result each), so it doubles as a budget cap. The run also stops at 'Maximum channels to check' or when YouTube has no more matching channels. Leave empty to check every channel up to the channel limit."
          },
          "onlyWithEmail": {
            "title": "Only save channels with an email",
            "type": "boolean",
            "description": "When on, channels without a public email are checked but not saved, so the dataset contains only contactable channels. Rows without email are always free either way.",
            "default": false
          },
          "minSubscribers": {
            "title": "Minimum subscribers",
            "minimum": 0,
            "type": "integer",
            "description": "Skip channels with fewer subscribers than this (e.g. 10000 for micro-influencers and up). Skipped channels are not saved, not charged and do not count toward the channel limit."
          },
          "maxSubscribers": {
            "title": "Maximum subscribers",
            "minimum": 0,
            "type": "integer",
            "description": "Skip channels with more subscribers than this (e.g. 500000 to avoid mega-creators who rarely answer)."
          },
          "countries": {
            "title": "Only channels from these countries",
            "type": "array",
            "description": "Keep only channels whose About page lists one of these countries. Use names (United States, India) or two-letter codes (US, IN). Channels with no country listed are skipped when this is set. Skipped channels are free and do not count toward the channel limit.",
            "items": {
              "type": "string"
            }
          },
          "activeWithinDays": {
            "title": "Only channels active in the last N days",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Skip channels that have not uploaded a video in this many days (e.g. 30). Inactive creators rarely answer outreach. Skipped channels are free and do not count toward the channel limit. Channels whose upload history cannot be loaded are skipped too."
          },
          "minAvgViews": {
            "title": "Minimum average views of recent videos",
            "minimum": 0,
            "type": "integer",
            "description": "Skip channels whose latest uploads average fewer views than this (e.g. 1000). Filters out dead or bought-subscriber channels. Skipped channels are free and do not count toward the channel limit. Channels whose upload history cannot be loaded are skipped too."
          },
          "scrapeWebsite": {
            "title": "Follow linked website to find hidden emails",
            "type": "boolean",
            "description": "When on and the channel's About panel has no email, the Actor opens the creator's own website (homepage, then up to two contact/about pages) to find a public email. Raises the email hit rate; adds a few seconds per channel.",
            "default": true
          },
          "followLinkAggregators": {
            "title": "Follow Linktree, Beacons, Bio.link pages",
            "type": "boolean",
            "description": "Follows the first link-in-bio page (Linktree, Beacons, Bio.link, Stan, Carrd and similar) found on the channel. These pages often hold the business email and every social profile.",
            "default": true
          },
          "verifyEmails": {
            "title": "Check that email domains can receive mail",
            "type": "boolean",
            "description": "Checks each email domain for a mail server (DNS MX record). Emails on domains that cannot receive mail are dropped, so you are not charged for them. No message is sent. Recommended: on.",
            "default": true
          },
          "verifyMailbox": {
            "title": "Check that the mailbox exists (optional)",
            "type": "boolean",
            "description": "Asks a mail-verification service whether each email's mailbox really exists, not only its domain. Mailboxes that do not exist are dropped and never charged. Free until 23 November 2026; from then $0.015 per email that was checked (emails that are not checked are free). Adds 1-3 seconds per email. Mailboxes on catch-all domains cannot be confirmed and are kept.",
            "default": false
          },
          "maxMailboxChecks": {
            "title": "Maximum mailbox checks per run",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Fair-use limit on mailbox checks in one run (only used when the mailbox check is on). Each channel's main email is checked first; extra checks are kept in proportion to the emails found.",
            "default": 100
          },
          "emailDomainsOnly": {
            "title": "Only keep emails on these domains",
            "type": "array",
            "description": "Keep only emails on these domains, e.g. gmail.com, or a brand domain. Other emails are dropped and not charged. Leave empty to keep all.",
            "items": {
              "type": "string"
            }
          },
          "excludeEmailDomains": {
            "title": "Drop emails on these domains",
            "type": "array",
            "description": "Emails on these domains are dropped and not charged (e.g. an agency that manages many creators).",
            "items": {
              "type": "string"
            }
          },
          "dedupeEmails": {
            "title": "Charge each email address only once",
            "type": "boolean",
            "description": "When several channels share one email (for example the same management team), the first channel is charged and later ones are saved free with email_is_duplicate = true. With a skip list, emails from earlier runs also count.",
            "default": true
          },
          "scanVideoDescriptions": {
            "title": "Find emails in recent video descriptions",
            "type": "boolean",
            "description": "Many creators only put their business email under their videos. Reads the latest uploads and keeps an email that repeats across videos or sits next to words like \"business\" or \"contact\", so one-off sponsor emails are ignored.",
            "default": true
          },
          "collectAllEmails": {
            "title": "Collect every email (slower)",
            "type": "boolean",
            "description": "Also visit the website after an email is already found, to collect every address the creator lists. Off by default for speed.",
            "default": false
          },
          "includeRecentActivity": {
            "title": "Add recent activity (last upload, average views)",
            "type": "boolean",
            "description": "Adds last upload date, title and link, uploads in the last 30 days, and average views of the latest uploads. Helps rank creators for outreach. Adds about one second per channel.",
            "default": true
          },
          "skipChannelsFromList": {
            "title": "Skip channels saved by earlier runs (list name)",
            "type": "string",
            "description": "Give a name (e.g. fitness-campaign). Channels saved under this name in earlier runs are skipped, and this run adds its channels to the list. The list lives in your own Apify storage. Leave empty to check every channel."
          },
          "outreachTemplate": {
            "title": "Outreach opening line (optional)",
            "type": "string",
            "description": "Template for the ready-to-use opening line saved on every row. Placeholders: {channel_name}, {last_video_title}, {handle}, {subscribers}. Leave empty for a default line that mentions the creator's latest video."
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Leave empty for the default: cheap datacenter proxies first, US residential proxies only when YouTube or a website blocks. Set your own proxy group or URLs only if you need a specific route."
          },
          "unlockBusinessInquiryEmail": {
            "title": "Also unlock YouTube \"View email address\" (optional, needs your Google cookies)",
            "type": "boolean",
            "description": "Most users leave this OFF. Default public scrape already reads About text, mailto links, websites, and Linktree-style pages. Turn this ON only when the user explicitly wants the business inquiry email behind YouTube's \"View email address\" button (login-gated). Requires youtubeSessionCookies owned by the caller. Costs a separate $0.12 inquiry-email-unlocked event only when unlock succeeds for a channel that had no public email. Captcha, expired cookies, and daily limits can still return no email — there is no guarantee. Never enable for smoke tests or MCP probes. Never invent cookies.",
            "default": false
          },
          "youtubeSessionCookies": {
            "title": "YouTube session cookies (secret)",
            "type": "string",
            "description": "Required only when unlockBusinessInquiryEmail is true. Paste a logged-in YouTube/Google session as a Cookie header string (for example SAPISID=…; __Secure-3PSID=…; LOGIN_INFO=…) or a JSON object of {cookieName: value}. Use a session the caller owns. Cookies are used only for the optional inquiry unlock path, are never written to the dataset or OUTPUT, and expired cookies produce an honest miss rather than a crash. Leave empty when unlock is off. Agents must ask the user for cookies — never invent them."
          },
          "maxInquiryUnlocksPerRun": {
            "title": "Max inquiry unlocks this run",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "Maximum number of channels for which the optional View-email unlock may be attempted in this run (only when unlock is on and the public path found no email). Use 1–5 for tests. Raise only when the user asks for bulk gated unlocks. Range 1–50. Default 10. Protects the caller's Google session from burn.",
            "default": 10
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}