---
title: "Social Email Finder"
method: GET
path: "/social-email-finder"
---

# Social Email Finder

`GET /social-email-finder`

## Request

- Base URL: `https://api.minelead.io/v1`
- URL: `https://api.minelead.io/v1/social-email-finder`
- Auth: API key in query parameter `key`

Find verified professional emails from a YouTube channel or Twitter/X profile URL. Pass the social media profile URL and receive emails grouped by domain, each with a quality score, verification status, and email type (personal vs generic).

Cost: 2 credits per successful request (emails found). No charge if no emails are found.

## Query parameters

- `key` string, required
- `url` string, required

## Response `200`

Social email finder result

- SocialEmailFinder
  - `status` string: "found" | "not-found" | "error"
  - `social_url` string: The social profile URL submitted
  - `platform` string: "youtube" | "twitter"
  - `channel_name` string: Display name of the channel or profile
  - `message` string
  - `timestamp` number
  - `domains` object[]
    - `domain` string
    - `confidence` string: "primary" = main brand website · "secondary" = additional linked site
    - `status` string
    - `name` string: Company name
    - `pattern` string, nullable: Detected email format pattern
    - `emails` object[]
      - `email` string
      - `quality` integer: 0-100 deliverability score. 75+ recommended for outreach.
      - `verified` boolean
      - `name` string
      - `email_type` string: "personal" or "generic"
      - `saved` boolean

## Other responses

- `400`: Missing or invalid parameters
- `401`: Authentication required
- `402`: Insufficient credits

---

[API](https://skmtc.dev/minelead/apis/minelead-api.md) · [All operations](https://skmtc.dev/minelead/apis/minelead-api/llms.txt) · [OpenAPI document](https://skmtc.dev/minelead/apis/minelead-api/revisions/c61c296b019b?raw)