# Prospeo

> Find and verify B2B work emails and mobile numbers, and enrich people and companies, straight from Prospeo.

App · Marketing Automation · 4 actions. Web page: https://docs.lodol.com/docs/integrations/prospeo

## Actions

### Enrich company

Get a company's profile (headcount, industry, location, founding year, and more) from its website, name, LinkedIn URL, or company ID.

**Inputs**

- Company website (`company_website`, text): The company's website domain, e.g. acme.com. Matches best.
- Company name (`company_name`, text): Optional. The company's name.
- Company LinkedIn URL (`company_linkedin_url`, text): Optional. The company's LinkedIn URL.
- Company ID (`company_id`, text): Optional. A company ID from a prior enrichment.

**Outputs**

- `company_id` (text): Prospeo company ID
- `description` (text): Company description
- `domain` (text): Primary domain
- `employee_count` (number): Approximate employee count
- `employee_range` (text): Employee count range, e.g. '51-100'
- `found` (true/false): Whether a matching company was found
- `founded` (number): Year the company was founded (0 if unknown)
- `industry` (text): Industry
- `linkedin_url` (text): Company LinkedIn URL
- `location` (text): Headquarters as 'City, State, Country'
- `name` (text): Company name
- `website` (text): Website URL

**Example output**

```json
{
  "company_id": "cmp_7a1b2c3d4e",
  "description": "Product analytics for modern software teams.",
  "domain": "acme.com",
  "employee_count": 84,
  "employee_range": "51-100",
  "found": true,
  "founded": 2016,
  "industry": "Software Development",
  "linkedin_url": "https://www.linkedin.com/company/acme-analytics",
  "location": "San Francisco, California, United States",
  "name": "Acme Analytics",
  "website": "https://acme.com"
}
```

### Enrich person

Find a person's verified work email (and optionally mobile) plus profile data. Match on a LinkedIn URL, an email, a person ID from Search people, or a name together with a company.

**Inputs**

- LinkedIn URL (`linkedin_url`, text): Optional. The person's LinkedIn profile URL.
- Email (`email`, text): Optional. A known email to enrich from.
- Person ID (`person_id`, text): Optional. A person ID returned by Search people.
- First name (`first_name`, text): Optional. Used with a company to match by name.
- Last name (`last_name`, text): Optional. Used with a company to match by name.
- Full name (`full_name`, text): Optional. Alternative to first + last name; used with a company to match by name.
- Company name (`company_name`, text): Optional. The person's employer name.
- Company website (`company_website`, text): Optional. The employer's website domain, e.g. acme.com.
- Company LinkedIn URL (`company_linkedin_url`, text): Optional. The employer's LinkedIn URL.
- Also find mobile (`enrich_mobile`, true/false): Optional. Also look up the person's mobile number. Costs extra credits; the email is still included. Default: `false`.

**Outputs**

- `company_domain` (text): Current company domain
- `company_name` (text): Current company name
- `email` (text): Work email. Empty in search results -- reveal it with Enrich person.
- `email_status` (text): Email status: VERIFIED, UNVERIFIED, or empty
- `first_name` (text): First name
- `found` (true/false): Whether a matching person was found
- `full_name` (text): Full name
- `job_title` (text): Current job title
- `last_name` (text): Last name
- `linkedin_url` (text): LinkedIn profile URL
- `location` (text): Location as 'City, State, Country'
- `mobile` (text): Mobile number in international format, when revealed
- `person_id` (text): Prospeo person ID. Pass to Enrich person to reveal contact details.

**Example output**

```json
{
  "company_domain": "acme.com",
  "company_name": "Acme Analytics",
  "email": "jordan@acme.com",
  "email_status": "VERIFIED",
  "first_name": "Jordan",
  "found": true,
  "full_name": "Jordan Rivera",
  "job_title": "Chief Executive Officer",
  "last_name": "Rivera",
  "linkedin_url": "https://www.linkedin.com/in/jordanrivera",
  "location": "San Francisco, California, United States",
  "mobile": "+1 415-555-0142",
  "person_id": "prs_0f9a1b2c3d"
}
```

### Get account info

Check the connected Prospeo account's plan, remaining credit balance, and next quota renewal. Free to call.

**Inputs**: None.

**Outputs**

- `current_plan` (text): Name of the current plan
- `current_team_members` (number): Members on the account
- `next_quota_renewal_date` (text): Date the credit quota renews
- `next_quota_renewal_days` (number): Days until the credit quota renews
- `remaining_credits` (number): Credits remaining this quota period
- `used_credits` (number): Credits used this quota period

**Example output**

```json
{
  "current_plan": "Growth",
  "current_team_members": 3,
  "next_quota_renewal_date": "2026-08-09",
  "next_quota_renewal_days": 12,
  "remaining_credits": 4200,
  "used_credits": 800
}
```

### Search people

Search Prospeo's B2B database for people matching job title, seniority, location, or keyword filters. Results include a person ID you can pass to Enrich person to reveal contact details.

**Inputs**

- Keywords (`keywords`, list): Optional. Free-text terms matched across name, company name, and domain (e.g. a company name).
- Job titles (`job_titles`, list): Optional. Job titles to match (contains), e.g. 'Head of Sales', 'CEO'.
- Seniorities (`seniorities`, list): Optional. Seniority levels to include. One or more of: `Founder/Owner`, `C-Suite`, `Partner`, `Vice President`, `Head`, `Director`, `Manager`, `Senior`, `Entry`, `Intern`.
- Locations (`locations`, list): Optional. Locations to include (e.g. 'United States', 'London').
- Verified email only (`verified_email_only`, true/false): Optional. Only return people who have a verified work email on file. Default: `false`.
- Page (`page`, number): Page number to fetch (1-1000). Each page returns up to 25 people. From 1 to 1000. Default: `1`.

**Outputs**

- `current_page` (number): The page these results are from
- `results` (list): People on this page
- `total_count` (number): Total people matching the filters
- `total_pages` (number): Total pages available for these filters

**Example output**

```json
{
  "current_page": 1,
  "results": [
    {
      "company_domain": "acme.com",
      "company_name": "Acme Analytics",
      "email": "",
      "email_status": "",
      "first_name": "Jordan",
      "full_name": "Jordan Rivera",
      "job_title": "Chief Executive Officer",
      "last_name": "Rivera",
      "linkedin_url": "https://www.linkedin.com/in/jordanrivera",
      "location": "San Francisco, California, United States",
      "mobile": "",
      "person_id": "prs_0f9a1b2c3d"
    }
  ],
  "total_count": 128,
  "total_pages": 6
}
```