Key filters: `job_title`, `location`, `industry`, `company_headcount_range`, `seniority_level`, `job_function` (arrays). `company_name` is a **string** (not array). At least one of `company_name`, `company_link`, or `company_id` is required.

> **Note:** This endpoint queries LinkedIn in real-time and can take 15-60+ seconds to respond.

Response: `{ "amount": N, "leads": [...] }` — each lead has `full_name`, `headline`, `job_title`, `company_name`, `company_website`, `linkedin_url`, `jobs[]`, `educations[]`, `skills[]`.

### Count Leads by ICP
`POST /api/linkedin/leads/count/`

Estimate the number of leads matching ICP filters (same body as search, no results returned).

### Search Companies by ICP
`POST /api/linkedin/companies/by_icp/`

Find companies by ICP. Returns company profiles with headcount, industry, location, funding.

Key filters: `industry`, `location`, `headcount_range`, `company_type`, `founded_year_min`, `founded_year_max`, `keyword`.

Response: `{ "amount": N, "companies": [...] }` — each has `name`, `domain`, `industry`, `headcount_range`, `headcount_exact`, `location`, `description`, `linkedin_link`, `website`, `founded_year`.

### Count Companies by ICP
`POST /api/linkedin/companies/count/`

Estimate the number of companies matching ICP filters.

### Get Lead by LinkedIn URL
`POST /api/linkedin/leads/by_link/`

Returns full enriched profile for a specific LinkedIn URL.

### Get Company by LinkedIn URL
`POST /api/linkedin/companies/by_link/`

Returns full company profile for a specific LinkedIn company URL.

### Email Finder (Generate Email)
`POST /api/linkedin/email_finder/`

AI-powered email discovery from name + domain. Generated emails are automatically validated.

Response: `{ "email": "...", "result": "valid|risky|invalid", "catch_all": bool, "valid_email": "...", "source": "...", "mx_domain": "..." }`

### Email Validator
`POST /api/linkedin/email_validator/`

Response: `{ "result": "valid|invalid|risky", "catch_all": bool, "mx_domain": "...", "exist": "yes|no" }`

### Get User Info
`GET /api/linkedin/user/me/`

Returns current user info and balance.

### Get Transactions
`GET /api/linkedin/transactions/`

Returns list of API usage transactions.

## Usage via curl

{
  "job_title": ["CEO", "CTO"],
  "location": ["United States"],
  "industry": ["Software Development"],
  "company_headcount_range": ["11-50", "51-200"],
  "page": 1,
  "per_page": 10
}

{
  "industry": ["Software Development"],
  "location": ["San Francisco"],
  "headcount_range": ["51-200"],
  "page": 1,
  "per_page": 10
}

[
  {
    "first_name": "John",
    "last_name": "Doe",
    "domain": "example.com"
  }
]

curl -X POST https://api.generect.com/api/linkedin/leads/by_icp/ \
  -H "Authorization: Token $GENERECT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job_title":["VP Sales"],"location":["United States"],"per_page":5}'