🎯 Domain Lead Limiter

Limit the number of leads (rows) per company domain in your CSV. When leads must be removed, the actor keeps the most senior people and prioritises technology-sector job titles.

---

📌 What it does

You upload a CSV containing leads scraped from various sources. Many of those leads share the same company domain - for example, 7 employees from one company. You only need 2 or 3 contacts per company, not all 7.

This actor:

1. Groups all leads by their company domain
2. For any domain that exceeds your configured limit, removes the lowest-priority leads
3. Outputs the remaining leads with every column preserved in the exact same order as the input

---

🏆 How leads are prioritised (what gets kept vs removed)

Seniority hierarchy (highest to lowest)

Level	Examples
10 - C-Suite	CEO, CTO, CIO, CISO, COO, CFO, CMO, Chief Technology Officer
9 - President / Owner / Founder	President, Owner, Founder, Co-Founder
8 - Vice President	VP of IT, SVP, EVP, Vice President of Engineering
7 - Director	Managing Director, IT Director, Director of Technology, Technical Director
6 - Head / Group Lead	Head of IT, Head of Engineering, Group Lead
5 - Manager / Partner	IT Manager, Managing Partner, General Manager, Principal
4 - Architect / Lead / Staff	Systems Architect, Lead Engineer, Staff Engineer, Principal Consultant
3 - Senior	Senior Engineer, Senior Consultant, Senior Analyst
2 - Mid-level	Engineer, Specialist, Consultant, Analyst, Administrator
1 - Junior / Entry	Junior Developer, Intern, Trainee, Associate, Assistant
0 - Unknown	Any title not matching the above - removed first

Tech-sector priority (tiebreaker)

This actor is built to prioritise technology-sector job titles.

When two leads have the same seniority level, the tech-related title is kept and the non-tech title is removed. For example:

• Director of Technology (level 7, tech) is kept over Director of Sales (level 7, non-tech)
• IT Manager (level 5, tech) is kept over Marketing Manager (level 5, non-tech)
• CTO (level 10, tech) is kept over CFO (level 10, non-tech)

Tech-related titles are identified by keywords such as: IT, technology, engineering, software, infrastructure, cloud, security, cyber, data, DevOps, systems, network, CTO, CIO, CISO, and many more.

When titles are unrecognised

If a job title does not match any known seniority pattern, it is assigned level 0 and will be the first to be removed. Among multiple unknown titles, the original CSV row order is preserved (earlier rows are kept).

---

🚀 How to use it

1. Upload your CSV file - the file must contain at least a domain column and a job title column
2. Specify the domain column name (e.g. domain, website, company_domain) - or leave blank to auto-detect
3. Specify the job title column name (e.g. title, job_title, position) - or leave blank to auto-detect
4. Set the max leads per domain - for example, 2 means keep at most 2 leads per company
5. Run the actor
6. Export the results - the output has the same columns in the same order as your input, minus the removed leads

Column name matching is not case-sensitive. Domain, DOMAIN, and domain all work.

---

📤 Output

The output dataset contains exactly the same columns as your input CSV, in the same order. The only difference is that excess leads have been removed. No columns are added or modified.

---

📋 Example

Input CSV (5 leads, 2 domains):

domain	name	title
acme.com	Alice	CEO
acme.com	Bob	CTO
acme.com	Carol	Junior Developer
acme.com	Dave	Sales Director
acme.com	Eve	IT Manager
globex.com	Frank	Managing Director
globex.com	Grace	Intern

Settings: max 2 leads per domain

Output (4 leads):

domain	name	title
acme.com	Alice	CEO
acme.com	Bob	CTO
globex.com	Frank	Managing Director
globex.com	Grace	Intern

From acme.com, Carol (Junior, level 1), Dave (Sales Director, level 7 non-tech), and Eve (IT Manager, level 5 tech) were candidates for removal. Carol is removed first (lowest level), then between Dave and Eve - Dave is removed because Eve has a tech title. Alice (CEO) and Bob (CTO) are kept as the top 2.

---

📊 Log output

The actor logs a clear summary:

📄 CSV loaded: 1,250 total leads
🌐 Domain column: "domain"
💼 Job title column: "title"
🔢 Max leads per domain: 2

📊 Found 340 unique domains
⚠️ 85 domains have more than 2 leads (430 leads total in those domains)

✂️ Trimming to 2 lead(s) per domain (keeping highest seniority, prioritising tech titles)...

   acme.com: 5 leads -> kept 2, removed 3
   globex.com: 4 leads -> kept 2, removed 2
   ...

✅ Done!

   Total leads in input:     1,250
   Unique domains:           340
   Max leads per domain:     2
   Domains trimmed:          85
   Leads removed:            260
   Leads kept (output):      990