Skill: Generect API

Owner: vokaplok

Summary: Search B2B leads and companies, find/validate emails via Generect Live API. Use when the user needs to find people by job title/company/industry, search companies by ICP, generate business emails from name+domain, or validate email addresses. Covers lead generation, prospecting, enrichment, and email discovery workflows.

Tags: latest:1.0.0

Version history:

v1.0.0 | 2026-02-09T22:53:03.043Z | user

Initial release — B2B lead search, company search, email generation & validation

Archive index:

Archive v1.0.0: 4 files, 3620 bytes

Files: references/api-filters.md (2253b), scripts/generect.sh (1121b), SKILL.md (3638b), _meta.json (131b)

File v1.0.0:SKILL.md

name: generect-api description: Search B2B leads and companies, find/validate emails via Generect Live API. Use when the user needs to find people by job title/company/industry, search companies by ICP, generate business emails from name+domain, or validate email addresses. Covers lead generation, prospecting, enrichment, and email discovery workflows.

Generect Live API

Real-time B2B data from LinkedIn, Crunchbase, and AI-powered email discovery.

Base URL: https://api.generect.com Auth: Authorization: Token <GENERECT_API_KEY>

Setup

Requires GENERECT_API_KEY environment variable. Get a key at https://beta.generect.com

Endpoints

Search Leads

POST /api/v1/leads/by_icp/

Find people by ICP filters. Returns enriched LinkedIn profiles with job history, education, skills.

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

Key filters: job_title, location, industry, company_headcount_range, company_name, seniority_level, job_function. All accept arrays.

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

Search Companies

POST /api/v1/companies/by_icp/

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

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

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.

Get Lead by LinkedIn URL

POST /api/v1/leads/by_url/

{ "url": "https://www.linkedin.com/in/username/" }

Returns full enriched profile for a specific LinkedIn URL.

Generate Email

POST /api/v1/email_generator/

AI-powered email discovery from name + domain.

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

Response: { "email": "...", "result": "valid|risky|invalid", "catch_all": bool }

Validate Email

POST /api/v1/email_validator/

{ "email": "[email protected]" }

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

Usage via curl

curl -X POST https://api.generect.com/api/v1/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}'

MCP Server (Alternative)

Generect also provides an MCP server for AI tool integrations:

• Remote: mcp-remote https://mcp.generect.com/mcp --header "Authorization: Bearer Token API_KEY"
• Local: npx -y generect-ultimate-mcp@latest with env GENERECT_API_KEY

Tools: search_leads, search_companies, generate_email, get_lead_by_url, health

Tips

• amount: -1 in response means exact count unavailable; iterate pages until empty
• Leads endpoint is live — each request queries LinkedIn in real-time (may take 5-15s)
• Email generator uses AI permutations + validation; valid results are safe to send
• Combine lead search → email generation for full prospecting pipeline
• Rate limits apply per API key tier

File v1.0.0:_meta.json

{ "ownerId": "kn74vv0ptcgayb93pnmq33w1g980vaqr", "slug": "generect-api", "version": "1.0.0", "publishedAt": 1770677583043 }

File v1.0.0:references/api-filters.md

Generect API Filter Reference

Lead Search Filters (/leads/by_icp/)

| Filter | Type | Example | |--------|------|---------| | job_title | string[] | ["CEO", "Founder"] | | location | string[] | ["United States", "Germany"] | | industry | string[] | ["Software Development"] | | company_headcount_range | string[] | ["1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+"] | | company_name | string[] | ["Google", "Meta"] | | seniority_level | string[] | ["Director", "VP", "C-Suite", "Manager"] | | job_function | string[] | ["Sales", "Marketing", "Engineering"] | | keyword | string | Free-text search across profiles | | page | int | Pagination (starts at 1) | | per_page | int | Results per page (max 25) |

Company Search Filters (/companies/by_icp/)

| Filter | Type | Example | |--------|------|---------| | industry | string[] | ["Information Technology"] | | location | string[] | ["San Francisco"] | | headcount_range | string[] | ["51-200"] | | company_type | string[] | ["Privately Held", "Public Company"] | | founded_year_min | int | 2020 | | founded_year_max | int | 2025 | | keyword | string | Free-text company search | | page | int | Pagination | | per_page | int | Results per page |

Lead Response Fields

Each lead object contains:

• Identity: full_name, first_name, last_name, headline, linkedin_url
• Current job: job_title, company_name, company_website, company_industry, company_headcount_range, job_started_on, job_description
• Company: company_city, company_country, company_state, company_location
• History: jobs[] (all positions), educations[], certifications[]
• Other: skills[], languages[], is_premium, is_job_seeker

Company Response Fields

Each company object contains:

• Identity: name, domain, linkedin_link, linkedin_id, website
• Profile: description, tagline, industry, company_type, founded_year
• Size: headcount_exact, headcount_range
• Location: hq_city, hq_country, hq_state, hq_street, hq_postal_code
• Other: logo_url, specialities[], hashtags[], crunchbase_urn