Prospeo Platform Help

Help the user with Prospeo platform questions — from person/company enrichment and search through bulk operations, Chrome extension, API, and integrations.

Step 1 — Gather context

Ask the user:

What area of Prospeo do you need help with?
- A) Person enrichment — finding verified emails and phones for specific contacts
- B) Company enrichment — firmographic data, tech stack, funding
- C) Person search — searching 200M+ contacts with filters
- D) Company search — searching 30M+ companies with filters
- E) Bulk operations — enriching up to 50 records at once via API
- F) Chrome extension — LinkedIn Sales Navigator extraction
- G) API — authentication, endpoints, integration
- H) Integrations — HubSpot, Salesforce, Clay, Zapier, Make, n8n
- I) Credits & billing — understanding credit costs, managing usage
- J) Something else — describe it
What's your role?
- A) Sales rep / AE / BDR
- B) Sales manager / team lead
- C) RevOps / Sales Ops
- D) Growth / Marketing
- E) Developer / Engineer
- F) Founder / solo seller
- G) Other
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.

Step 2 — Route or answer directly

If the request maps to a specialized skill, route:

Building prospect lists from scratch → /sales-prospect-list
Enrichment strategy across multiple tools → /sales-enrich
Email deliverability / verification strategy → /sales-deliverability
Buying signals / intent interpretation → /sales-intent
Connecting tools / webhooks / Zapier → /sales-integration

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

Step 3 — Prospeo platform reference

Person Enrichment

The core Prospeo feature — find verified emails, mobile numbers, and full B2B profiles.

Input options (any one of these):

First name + last name + company identifier (name, website, or LinkedIn URL)
Full name + company identifier
LinkedIn URL (standalone)
Email address (standalone — reverse lookup)
Person ID (from a previous search)

What you get back:

Verified email with status (VERIFIED, NOT_VERIFIED)
Mobile number with verification status (costs 10 credits extra)
Full profile: job title, job history, headline, skills, location, timezone
Current company data: name, domain, industry, employee count, funding, tech stack, job postings

Key settings:

only_verified_email: true — only return results with a verified email (saves credits on unmatched)
enrich_mobile: true — include mobile number lookup (costs 10 credits instead of 1)
only_verified_mobile: true — only return results with a verified mobile

Credit costs:

Standard enrichment (person + company + email): 1 credit
With mobile: 10 credits (email included free)
No match found: free
Same record enriched again: free (lifetime dedup)

Company Enrichment

Firmographic data on 30M+ companies — 50+ data fields.

Input options (any one of these):

Company website/domain (most reliable)
Company LinkedIn URL
Company name (use with caution — less precise)
Company ID (from previous enrichment)

What you get back:

Basic info: name, website, domain, description
Classification: industry, type, SIC/NAICS codes
Size: employee count, employee range, revenue range
Location: HQ address, country, state, city
Social: LinkedIn, Twitter, Facebook, YouTube URLs
Financial: funding history, total funding, last funding date
Technology: tech stack detection
Engagement: job postings, B2B/B2C attributes, free trial/pricing indicators

Credit costs: 1 credit per matched company. Free for no match or duplicate.

Person Search

Search through 200M+ contacts with 30+ filters. Returns up to 25 results per page, max 25,000 total (1,000 pages).

Available filters:

Filter category	Filters
Company	industry, location, headcount range, funding (stage, date, amount, total), websites (up to 500), names (up to 500)
Person	seniority, department, location, job title, years of experience

Important: Search returns profile data but NOT emails or phones. You must use Enrich Person on results to get contact info. Search costs 1 credit per request that returns results.

Company Search

Search through 30M+ companies with filters. Same pagination as Person Search.

Available filters:

Industry, location, headcount range
Funding: stage, date, last amount, total amount
Technology stack, email provider (MX)
NAICS codes, SIC codes
Websites (up to 500), names (up to 500)

Credit cost: 1 credit per request that returns results.

Bulk Operations

Enrich up to 50 records per API call for both person and company enrichment.

Bulk Enrich Person: Same input options as single enrichment, but send an array of up to 50 records. Each record needs a unique identifier string for tracking. Response separates matched, not_matched, and invalid_datapoints.

Bulk Enrich Company: Same — up to 50 companies per call with identifiers.

Credit costs: Same as single enrichment (1 per matched person/company, 10 for mobile). total_cost field in response tracks total credits spent.

Chrome Extension

Prospeo's Chrome extension extracts contact data from LinkedIn and LinkedIn Sales Navigator.

What it does:

Find verified emails from LinkedIn profiles
Extract contact data while browsing Sales Navigator
One-click enrichment without switching to the Prospeo app

5-Step Email Verification

Prospeo uses a 5-step verification process (built into enrichment — not a separate endpoint):

Syntax check — valid email format
Domain/MX check — domain exists and accepts email
SMTP verification — mailbox exists
Catch-all detection — identifies domains that accept all addresses
Result validation — cross-references multiple signals

Verification statuses: VERIFIED (safe to send), NOT_VERIFIED (use with caution).

Prospeo data model

Entity	What it represents	Key relationships
Person	A B2B professional with contact info	Has email, mobile, job history, skills; linked to Company
Company	An organization with firmographic data	Has employees, funding, tech stack, job postings
Search	A filtered query across the database	Returns Person or Company results (no contact info)
Enrichment	A lookup that returns full contact data	Consumes credits; lifetime dedup per account

API quick reference

Base URL: https://api.prospeo.io
Auth: X-KEY header with API key
Method: POST for all endpoints (GET for account-information only)
Content-Type: application/json
Rate limits: Per-plan, tracked via response headers (x-daily-request-left, x-minute-request-left, x-second-rate-limit)
Active endpoints: /enrich-person, /bulk-enrich-person, /enrich-company, /bulk-enrich-company, /search-person, /search-company, /search-suggestions, /account-information
Deprecated (removed March 1, 2026): /email-finder, /mobile-finder, /email-verifier, /domain-search, /social-url-enrichment

For the full endpoint catalog, request/response schemas, and rate limits, see references/prospeo-api-reference.md.

Integrations

Integration	Type	What it does
HubSpot	Native	Enrich CRM contacts with verified emails, phones, firmographic data
Salesforce	Native	Keep CRM data clean with enriched contacts and accounts
Clay	Native	Automate data enrichment in Clay workflows, build dynamic lead lists
Smartlead	Native	Push enriched leads to Smartlead campaigns
Instantly	Native	Push enriched leads to Instantly campaigns
Lemlist	Native	Push enriched leads to Lemlist sequences
Zapier	Native	Connect to 8,000+ apps for automated workflows
Make	Native	Visual automation workflows with Prospeo actions
n8n	Native (community node)	Self-hosted automation with `@prospeo/n8n-nodes-prospeo`
MCP Server	Official (`@prospeo/mcp-server`)	Access enrichment and search from AI agents via Model Context Protocol

Pricing

As of March 2026 — verify current pricing at prospeo.io/pricing

Plan	Price/mo	Credits/mo	Key features
Free	$0	75	Core enrichment, Chrome extension
Starter	$39	1,000	Full API access
Growth	$99	5,000	Team sharing
Pro	$199	20,000	Priority support
Business	$369	50,000	High-volume enrichment

All plans include person + company enrichment, search, Chrome extension, and API access. Mobile enrichment costs 10 credits per lookup on all plans.

Step 4 — Actionable guidance

Based on the user's specific question:

Step-by-step instructions — numbered steps to accomplish their goal in Prospeo
Configuration recommendations — specific settings, with navigation paths
Common pitfalls — what can go wrong and how to avoid it
Verification — how to confirm the change worked
For API questions — always include: "For the full endpoint catalog, request/response schemas, and rate limits, see references/prospeo-api-reference.md."

Gotchas

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

Don't confuse Search with Enrichment. Person Search and Company Search return profile data but NOT emails or phones. You must call Enrich Person/Company separately to get contact info. This is a two-step process and each step costs credits.
Don't forget mobile enrichment costs 10x. A standard enrichment is 1 credit, but adding enrich_mobile: true makes it 10 credits. At scale this adds up fast. Only enable mobile for contacts you'll actually call.
Don't use deprecated endpoints. The old Email Finder, Mobile Finder, Email Verifier, Domain Search, and Social URL Enrichment endpoints were removed March 1, 2026. Use the new Enrich Person/Company endpoints instead.
Don't ignore the lifetime dedup. Prospeo doesn't charge for re-enriching the same record. If you need updated data on someone you've already enriched, re-run the enrichment for free. But note this is per-account, not per-team-member.
Don't search by company name alone. Company name matching is fuzzy and can return wrong results. Always use website/domain or LinkedIn URL as the company identifier when possible.

Step 5 — Related skills

/sales-enrich — Enrichment strategy across multiple tools (waterfall, CRM hygiene, credit optimization)
/sales-prospect-list — Build prospect lists to enrich with Prospeo
/sales-deliverability — Email deliverability — verify emails before sending
/sales-intent — Layer buying signals on enriched contacts to prioritize outreach
/sales-cadence — Design outbound sequences for enriched contacts
/sales-integration — Connect Prospeo to other tools via API, Zapier, Make, n8n
/sales-do — Not sure which skill to use? The router matches any sales objective to the right skill. Install: npx skills add sales-skills/sales --skills sales-do

Examples

Example 1: Enrich a list of prospects

User says: "I have 200 LinkedIn URLs from Sales Navigator. How do I enrich them all with emails in Prospeo?" Skill does:

Recommends using the Bulk Enrich Person API endpoint with LinkedIn URLs
Explains batching into groups of 50 (API limit per call)
Shows the API request format with linkedin_url as the data field
Recommends setting only_verified_email: true to save credits
Calculates credit cost: 200 credits max (1 per match, free for no-match) Result: User has a batched enrichment plan with API examples and credit estimate

Example 2: Find decision-makers at target companies

User says: "I need to find VP-level contacts at 50 SaaS companies with 100-500 employees" Skill does:

Recommends using Search Person with company filters (headcount_range, industry) and person filters (seniority: VP)
Shows how to use company.websites filter with a list of target domains
Explains that search results need separate enrichment to get emails
Suggests a workflow: Search → filter results → Bulk Enrich top matches Result: Two-step search-then-enrich workflow with filter configuration

Example 3: API integration with CRM

User says: "How do I set up auto-enrichment of new HubSpot contacts with Prospeo?" Skill does:

Checks if the user wants native HubSpot integration or custom API pipeline
For native: walks through connecting HubSpot in Prospeo settings
For custom: designs a Zapier/Make workflow — HubSpot "New Contact" trigger → Prospeo Enrich Person action → HubSpot "Update Contact" with enriched fields
Addresses credit budgeting for ongoing auto-enrichment Result: Auto-enrichment pipeline with credit management strategy

Troubleshooting

Low match rate on enrichments

Symptom: Many records return NO_MATCH Cause: Insufficient identifying data, or contacts are in niche industries with low database coverage Solution: Provide multiple data points (name + company website + LinkedIn URL) for best matching. Use only_verified_email: false to see unverified results. For low-coverage segments, consider waterfall enrichment with multiple providers — see /sales-enrich.

API returning 429 errors

Symptom: Rate limit exceeded errors on API calls Cause: Sending too many requests per minute/second for your plan tier Solution: Check response headers (x-minute-request-left, x-second-rate-limit) to understand your limits. Implement exponential backoff on 429 responses. Use bulk endpoints (50 records per call) instead of single enrichments to reduce request count.

Credits running out mid-month

Symptom: INSUFFICIENT_CREDITS error before billing cycle resets Cause: Mobile enrichment consuming 10x credits, or bulk operations enriching unqualified records Solution: Check usage via the Account Information endpoint or dashboard. Disable enrich_mobile for contacts you won't call. Use only_verified_email: true to skip unverifiable records. Apply ICP filters before enriching — don't enrich contacts you'll never reach out to.

sales-prospeo