sales-enrichso

What this skill does

# Enrich.so Platform Help

Help the user with Enrich.so platform questions — from Reverse Email Lookup and LinkedIn Profile Enrichment through Email/Phone Finders, Company Data, Similar Company Search, Employee Search, IP to Company, Job Listings, Bulk Enrichment, and Email Validation. Enrich.so is a real-time B2B datan enrichment API platform providing 50+ data points per lookup with a success-based credit model (only pay for verified results).

## Step 1 — Gather context


If `references/learnings.md` exists, read it first for accumulated knowledge.

Ask the user:

1. **What area of Enrich.so do you need help with?**
   - A) Reverse Email Lookup — find LinkedIn profile, job title, company, and 50+ data points from an email address
   - B) LinkedIn Profile Enrichment — get full profile data from a LinkedIn URL (education, positions, skills, contact info, network info)
   - C) Email Finder — find verified business email from name + company, or LinkedIn to Email
   - D) Phone Number Finder — find phone numbers from profiles, Email to Phone, Mobile Finder
   - E) Company Data Lookup — company details by name, domain, or LinkedIn URL (industry, size, revenue, tech stack, social profiles)
   - F) Company Funding & Traffic — funding rounds, investors, amounts, web traffic estimates
   - G) Search Similar Companies — find lookalike companies by LinkedIn URL with filters (location, employee size)
   - H) Search Company Employees — find decision-makers by company and role with detailed profiles
   - I) IP to Company — identify company from IP address (including remote workers)
   - J) Job Listings — real-time company job postings search
   - K) Bulk Enrichment — batch processing via CSV upload, JSON array, or CSV URL with webhook callbacks
   - L) Email Validation / Disposable Email Check / Reverse Email Append
   - M) Integrations / API — REST API, Zapier, n8n, Make, webhooks
   - N) Account / Billing — plans, pricing, credits
   - O) Something else — describe it

2. **What's your role?**
   - A) Sales / SDR / BDR
   - B) RevOps / Sales ops
   - C) Developer / engineer
   - D) Growth / marketing
   - E) Recruiter / talent acquisition
   - F) Other

3. **What are you trying to accomplish?** (describe your specific goal or question)

**If the user's request already provides most of this context, skip directly to the relevant step.** Lead with your best-effort answer using reasonable assumptions (stated explicitly), then ask only the most critical 1-2 clarifying questions at the end — don't gate your response behind gathering complete context.

Note: If the user needs a specialized skill, route them there with a brief explanation of why that skill is a better fit.

## Step 2 — Route or answer directly

If the request maps to a specialized skill, route:
- Cross-platform enrichment strategy / multi-tool enrichment -> `/sales-enrich`
- Email deliverability / verification strategy (not Enrich.so-specific) -> `/sales-deliverability`
- Prospect list building strategy -> `/sales-prospect-list`
- Connecting Enrich.so to other tools via middleware -> `/sales-integration`
- Apollo.io-specific questions -> `/sales-apollo`
- ZoomInfo-specific questions -> `/sales-zoominfo`
- Clearbit-specific questions -> `/sales-clearbit`

Otherwise, answer directly from platform knowledge using the reference below.

## Step 3 — Enrich.so platform reference

**Read `references/platform-guide.md`** for detailed module documentation, pricing, integrations, and data model.

*You no longer need the platform guide details — focus on the user's specific situation.*

## Step 4 — Actionable guidance

Based on the user's specific question:

1. **Enriching a list of email contacts with LinkedIn data**:
   1. Prepare your list as a CSV with an `email` column
   2. Use the Bulk Enrichment endpoint: `POST /v1/api/bulk-enrichment` with type `person` and upload your CSV (or pass a JSON array or CSV URL)
   3. Include `webhookUrl` in the request body to receive a callback when processing completes — avoids polling
   4. Retrieve results: `GET /v1/api/bulk-enrichment-results?uid=<uid>` using the uid returned from the submit call
   5. Results include LinkedIn URL, job title, company, location, and 50+ data points for each matched email
   6. Import enriched data back into your CRM — map fields to your CRM's contact properties
   7. Only successfully enriched records consume credits — no charge for unmatched emails

2. **Finding decision-maker emails at target accounts**:
   1. Start with your target company's LinkedIn URL or domain
   2. Use Search Company Employees to find people by role: filter for titles like "VP Sales", "Head of Engineering", "CTO"
   3. For each matching employee, use LinkedIn to Email to get their business email address
   4. Validate each email with the Email Validation endpoint before outreach — check for catch-all domains and invalid mailboxes
   5. Optionally use the Phone Number Finder to add phone touchpoints for multi-channel sequences
   6. For large account lists, use Bulk Enrichment with type `find-email` to process in batch

3. **De-anonymizing website visitors with IP to Company**:
   1. Capture visitor IP addresses from your web server logs or analytics platform
   2. Call `GET /v1/api/ip-to-company` with each IP address
   3. Enrich.so returns the associated company name, domain, industry, size, and LinkedIn URL — works for remote workers too
   4. Match returned companies against your ICP criteria (industry, size, revenue) to prioritize follow-up
   5. Use Company Data Lookup to get full firmographic details on high-priority matches
   6. Use Search Company Employees to find the right contact at each identified company
   7. Automate the pipeline with Zapier (IP to Company trigger) or your integration platform of choice

4. **Building a lookalike company list**:
   1. Identify your best customers' LinkedIn company URLs
   2. Call `POST /v1/api/similar-companies` with each URL — optionally filter by location and employee size to match your ICP
   3. Results include relevancy scores — prioritize companies with scores above your chosen threshold
   4. Enrich top matches with Company Data Lookup for full firmographics (industry, revenue, tech stack)
   5. Use Search Company Employees to find decision-makers at each new target account
   6. Use Email Finder or LinkedIn to Email to get contact details for outreach

5. **Setting up Enrich.so API integration**:
   1. Sign up at enrich.so and retrieve your API token from the dashboard
   2. Set the Authorization header on all requests: `Authorization: Bearer <your-token>`
   3. Test with a single lookup: `GET https://api.enrich.so/v1/api/[email protected]`
   4. Handle responses: check the HTTP status code — 200 for success, 404 for no match (no credit charged), 401 for auth errors, 429 for rate limits
   5. For bulk workflows, use the async bulk enrichment endpoint rather than looping individual calls — more efficient and avoids rate limits
   6. Set up webhook callbacks for bulk jobs to avoid polling: include `webhookUrl` in the bulk request body
   7. Monitor credit usage in the Enrich.so dashboard — set up alerts to avoid unexpected depletion

## Gotchas

> *Best-effort from research — review these, especially items about plan-gated features and integration gotchas that may be outdated.*

1. **Success-based billing means no charge for misses, but credit costs vary by endpoint — check the pricing page for per-endpoint credit costs before budgeting.** A person enrichment lookup may cost a different number of credits than a company lookup or phone finder. Plan your credit allocation based on the mix of endpoints you use, not just the total number of lookups.
2. **Bulk enrichment is async — you must poll for results or use webhooks.** Submitting a bulk job returns a `uid` immediately, but results are not available in the response. You need to either poll `GET /v1/api/bulk-enrichment-results?uid=<ui