---
title: "Search"
method: GET
path: "/search"
---

# Search

`GET /search`

## Request

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

Search for leads

## Query parameters

- `key` string, required
- `domain` string, required
- `name` string
- `max-emails` number
- `generic` boolean
- `light-mode` boolean
- `enrich` boolean
- `deep` boolean
- `max_deep_results` integer

## Response `200`

- Search
  - `domain` string
  - `status` string
  - `pattern` string
  - `emails` Email[]
    - `email` string
    - `verified` boolean
    - `saved` boolean
    - `email_type` 'personal' | 'generic': 'personal' for individual addresses, 'generic' for role-based addresses (info@, support@, etc.)
    - `name` string, nullable: Full name of the person (populated when enrich=true)
    - `title` string, nullable: Job title (populated when enrich=true)
    - `location` string, nullable: City/country (populated when enrich=true)
    - `gender` 'male' | 'female' | 'null', nullable: Inferred gender (populated when enrich=true)
    - `industry` string, nullable: Broad industry sector (populated when enrich=true)
    - `summary` string, nullable: Short professional bio (populated when enrich=true)
  - `deep_search` DeepSearch: Returned when deep=true. Contains AI-discovered employee contacts for the domain.
    - `names_found` integer: Total number of employee names discovered.
    - `emails_verified` integer: Number of emails successfully verified.
    - `credits_charged` integer: Credits charged for this request (5 upfront + 2 per verified email).
    - `catch_all` boolean: If true, domain is catch-all and deep search was blocked (0 credits charged).
    - `persons` object[]
      - `name` string
      - `title` string, nullable
      - `email` string, nullable
      - `quality` integer: Email quality score 0–100.
      - `verified` boolean
      - `linkedin_url` string, nullable
      - `twitter_url` string, nullable
      - `github_url` string, nullable

---

[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)