---
title: Prospeo
description: Verified work emails and mobiles, plus people and company search with 40+ filters. Nothing to connect: Edgaze calls Prospeo and the cost is in the run's price.
source: https://www.edgaze.ai/docs/builder/nodes/integration-prospeo
section: builder
---
# Prospeo

> Verified work emails and mobiles, plus people and company search with 40+ filters. Nothing to connect: Edgaze calls Prospeo and the cost is in the run's price.

**Audience: Workflow creators.**

## Overview

Verified work emails and mobiles, plus people and company search with 40+ filters.

Use this block when its responsibility is clear in the graph. Give it a name that describes the work it performs, then test it with representative input before publishing.

## Setting it up

You do not need a Prospeo account or API key, and neither does anyone running the workflow. Edgaze is Prospeo's customer: each action has a fixed published price that is already part of the workflow's per-run price, so a run simply costs what it shows.

### Actions

- **Search for people** - Find people by title, seniority, department, location and 20+ company filters. 25 per page; emails come from Find emails in bulk.
- **Find a person's email** - Verified work email (and optionally mobile) plus full profile and company for one person.
- **Find emails in bulk** - Emails (and optionally mobiles) for up to 50 people in one call. Only people found are charged. Needs: People.
- **Search for companies** - Find companies by location, industry, size, tech stack, funding, revenue, hiring and lookalikes. 25 per page.
- **Enrich a company** - Firmographics for one company: size, industry, revenue, funding, tech stack, hiring, socials. Needs: Company.
- **Enrich companies in bulk** - Firmographics for up to 50 companies in one call. Only matches are charged. Needs: Companies.
- **Look up filter values** - Prospeo's exact spelling for locations, job titles, industries, technologies and more. Free. Needs: What to look up, Starts with.

### Filling in the fields

Every field can be filled three ways: **type it** (a fixed value), **from a step** (a value an earlier step produced - pick it from a list, no paths to type), or **text + steps** (fixed text with values from earlier steps woven in). The panel shows what will be sent and tells you before you publish if a field is missing or points at a step that is no longer connected.

### Limits and pricing

Prices are in USD per call, include the platform margin, and are shown rounded up to the next cent; billing itself computes exact amounts. A run always reserves the maximum an action can cost before it starts, and lookups the provider gates out (for example an unmet required field, or a free preview) are not billed.

| Action                                                  | Price                                | What changes it                                                           |
| ------------------------------------------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
| ![](/integrations/prospeo.png) Search for people        | $0.03 per call                       | Only billed when something is found                                       |
| ![](/integrations/prospeo.png) Find a person's email    | $0.03 per call                       | +$0.25 when a mobile number is found; Only billed when something is found |
| ![](/integrations/prospeo.png) Find emails in bulk      | $0.03 per lookup (up to 50 per call) | +$0.25 when a mobile number is found; Only billed when something is found |
| ![](/integrations/prospeo.png) Search for companies     | $0.03 per call                       | Only billed when something is found                                       |
| ![](/integrations/prospeo.png) Enrich a company         | $0.03 per call                       | Only billed when something is found                                       |
| ![](/integrations/prospeo.png) Enrich companies in bulk | $0.03 per lookup (up to 50 per call) | Only billed when something is found                                       |
| ![](/integrations/prospeo.png) Look up filter values    | Free                                 | -                                                                         |

The most one call of this block can cost is $13.50 (Find emails in bulk with every option on). Batch actions bill per lookup and are capped at the vendor's own batch size.

### Trying it

Test runs make real Prospeo calls and are metered exactly like a published run, so test with the smallest inputs first. Lookups that find nothing are not charged.

## Working examples

These are complete starting points, not decorative diagrams. Every graph is also available in the main template library and is checked by the workflow compiler.

### 1. Find a lead's verified email

**You will build:** A verified work email with the person's title and company, ready for outreach.

No Prospeo account is needed: the lookup is part of the run price, and a miss is free. Nothing is charged when no one matches, and Matched = no lets the workflow branch instead of failing.

```docsgraph
block-integration-prospeo-find-a-lead-s-verified-email
```

[Open this template](/templates/block-integration-prospeo-find-a-lead-s-verified-email) and adapt the labels, prompts, or credentials to your own workflow.

### 2. Build a prospect list

**You will build:** 25 decision makers per page with verified emails, filtered by role and company.

Forty-plus filters, with locations, titles and industries suggested in Prospeo's own spelling. Pages bought in the last 30 days are free, and searches are paced to stay inside rate limits.

```docsgraph
block-integration-prospeo-build-a-prospect-list
```

[Open this template](/templates/block-integration-prospeo-build-a-prospect-list) and adapt the labels, prompts, or credentials to your own workflow.

### 3. Enrich a company list

**You will build:** Size, industry, funding, tech stack and hiring for up to 50 companies at once.

One call covers 50 companies, and each is charged only when Prospeo finds it. Results come back in the order you sent them, with Matched on each, so nothing gets misaligned.

```docsgraph
block-integration-prospeo-enrich-a-company-list
```

[Open this template](/templates/block-integration-prospeo-enrich-a-company-list) and adapt the labels, prompts, or credentials to your own workflow.

## Finding the right person

**Find a person's email** needs one of these, and the first is the most reliable:

- **A LinkedIn profile URL**, such as `linkedin.com/in/janedoe`.
- **A work email** they already use. Useful for refreshing a profile or checking an address is still valid.
- **A Prospeo person ID**, from the **Person IDs** output of **Search for people**.
- **A full name plus their company**, given as a website, a LinkedIn company page or a company name. A website matches best; a name alone is never enough.

**Find emails in bulk** takes the same identifiers, one per line or as a list from an earlier step, up to 50 people per call. To give a name and company on one line, write `Jane Doe @ acme.com`. A line that cannot identify anyone stops the step before anything is sent, and says which line it was.

**Also find a mobile number** costs more, and only when a mobile is actually found. Leave it off unless the workflow needs phone numbers.

## Building a list from a search

**Search for people** and **Search for companies** return 25 results per page. Search results do not include emails. To get them, connect **Search for people** to **Find emails in bulk** and set its **People** field to the search's **Person IDs** output: one page fits in one bulk call.

Each search also returns **Total count**, **Total pages** and **Next page**. To go through every page, feed **Next page** back into the **Page** field (for example inside a Loop). **Next page** is empty on the last page. Prospeo serves up to page 1,000.

Prospeo limits how fast searches can run, so Edgaze spaces search calls about a second apart. A loop over 100 pages takes at least 100 seconds, so give the run enough time.

Pages Prospeo already returned to Edgaze in the last 30 days, and people or companies enriched in the last 90 days, cost nothing when looked up again.

## Filters

Most filters are one click: **Seniority**, **Department**, **Company size** and **Latest funding stage** are lists to pick from.

**Job titles**, **Locations**, **Industries** and **Uses technologies** must match Prospeo's own spelling, so the panel suggests values as you type (for example "San Francisco Bay Area, United States"). Pick a suggestion where you can. A value Prospeo does not recognise makes the step fail with a message naming it, and nothing is charged.

Every filter in the panel narrows the search further. Leave a filter empty to ignore it. A search needs at least one filter.

**More filters (JSON)** accepts any other filter from [Prospeo's API reference](https://prospeo.io/api-docs) by its documented name, such as `company_headcount_growth`. It is merged with the fields above. A few advanced Prospeo filters are not available on Edgaze; a search that uses one fails with a message naming it, and nothing is charged.

## When nothing is found

Not finding someone is a normal answer, not an error. By default the step succeeds with **Matched** set to no and costs nothing, so the workflow can branch on it with a Condition.

Set **If nothing is found** to **Stop** when a missing result means the rest of the run is pointless. The step then goes to its **Error** output if you connected one, or ends the run if you did not.

**Only people with a verified email** and **Only people with a mobile number** treat anyone without one as not found, so they are not charged either. In bulk actions, every result has its own **Matched** and **Input**, in the order you sent them, so results never get misaligned.

## Using contact data responsibly

Emails and phone numbers from Prospeo are personal data. Use them only for purposes the law allows where you and the people you contact are, honour opt-out requests, and do not publish workflows whose purpose is to expose someone's contact details. See the [Acceptable Use Policy](/docs/acceptable-use-policy).

## Action reference

Every field and output of each action, exactly as the panel shows them. Fields under **Options** and **Advanced** are collapsed in the panel until you open them.

### Search for people

Find people by title, seniority, department, location and 20+ company filters. 25 per page; emails come from Find emails in bulk.

| Field                             | Where    | What to enter                                                                                                                                                                                                                        |
| --------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Job titles                        | Main     | Up to 100. Pick from the suggestions or type your own. Suggestions appear as you type.                                                                                                                                               |
| Title matching                    | Options  | Similar also finds close variants ("Head of Growth" for "Growth Lead"). Contains and Exact are stricter. Choices: similar, contains, exact. Default: similar.                                                                        |
| Exclude job titles                | Options  | Suggestions appear as you type.                                                                                                                                                                                                      |
| Seniority                         | Main     | Choices: Founder/Owner, C-Suite, Partner, Vice President, Head, Director, Manager, Senior, Entry, Intern.                                                                                                                            |
| Department                        | Main     | Choices: C-Suite, Consulting, Design, Education & Coaching, Engineering & Technical, Finance, Human Resources, Information Technology, Legal, Marketing, Medical & Health, Operations, Product, Sales.                               |
| Locations                         | Main     | Where the person is. Pick from the suggestions so the spelling matches. Suggestions appear as you type.                                                                                                                              |
| Exclude locations                 | Options  | Suggestions appear as you type.                                                                                                                                                                                                      |
| Keywords                          | Options  | Matched across the person's name, headline and company.                                                                                                                                                                              |
| Person names                      | Advanced | -                                                                                                                                                                                                                                    |
| Only people with a verified email | Options  | Recommended before Find emails in bulk, so every lookup returns an email.                                                                                                                                                            |
| Only people with a mobile number  | Advanced | -                                                                                                                                                                                                                                    |
| At most this many per company     | Options  | Spreads results across companies.                                                                                                                                                                                                    |
| Years of experience: at least     | Advanced | -                                                                                                                                                                                                                                    |
| Years of experience: at most      | Advanced | -                                                                                                                                                                                                                                    |
| Changed jobs in the last (days)   | Advanced | People who recently started a new role. Choices: 30, 60, 90, 180, 270, 365.                                                                                                                                                          |
| Job title boolean search          | Advanced | Replaces Job titles. AND, OR, ! to exclude, quotes for exact, brackets to group.                                                                                                                                                     |
| Company websites                  | Options  | Root domains only, no subdomains.                                                                                                                                                                                                    |
| Exclude company websites          | Options  | -                                                                                                                                                                                                                                    |
| Company names                     | Options  | -                                                                                                                                                                                                                                    |
| Company locations                 | Options  | Where the company is based. Pick from the suggestions so the spelling matches. Suggestions appear as you type.                                                                                                                       |
| Exclude company locations         | Options  | Suggestions appear as you type.                                                                                                                                                                                                      |
| Industries                        | Options  | Suggestions appear as you type.                                                                                                                                                                                                      |
| Exclude industries                | Options  | Suggestions appear as you type.                                                                                                                                                                                                      |
| Company size                      | Options  | Choices: 1-10, 11-20, 21-50, 51-100, 101-200, 201-500, 501-1000, 1001-2000, 2001-5000, 5001-10000, 10000+.                                                                                                                           |
| Custom size: at least             | Advanced | Instead of the size ranges: employees at least this many.                                                                                                                                                                            |
| Custom size: at most              | Advanced | -                                                                                                                                                                                                                                    |
| Company keywords                  | Options  | Words in the company's description, specialties or website. Up to 20.                                                                                                                                                                |
| Uses technologies                 | Options  | Companies whose stack includes these. Up to 20. Suggestions appear as you type.                                                                                                                                                      |
| Does not use technologies         | Advanced | Suggestions appear as you type.                                                                                                                                                                                                      |
| Latest funding stage              | Options  | Choices: Pre seed, Seed, Angel, Series A, Series B, Series C, Series D, Series E-J, Series unknown, Private equity, Debt financing, Convertible note, Corporate round, Equity crowdfunding, and 9 more.                              |
| Raised money in the last (days)   | Options  | Choices: 30, 60, 90, 180, 270, 365.                                                                                                                                                                                                  |
| Revenue at least (USD)            | Advanced | Choices: <100K, 100K, 500K, 1M, 5M, 10M, 25M, 50M, 100M, 250M, 500M, 1B, 5B, 10B+.                                                                                                                                                   |
| Revenue at most (USD)             | Advanced | Choices: <100K, 100K, 500K, 1M, 5M, 10M, 25M, 50M, 100M, 250M, 500M, 1B, 5B, 10B+.                                                                                                                                                   |
| Founded in or after               | Advanced | -                                                                                                                                                                                                                                    |
| Founded in or before              | Advanced | -                                                                                                                                                                                                                                    |
| Company type                      | Advanced | Choices: Private, Public, Non Profit, Other.                                                                                                                                                                                         |
| Email provider                    | Advanced | Companies whose mail runs on these providers. Choices: Google, Microsoft, Proofpoint, Mimecast, Other.                                                                                                                               |
| Hiring for                        | Options  | Job titles in the company's open postings.                                                                                                                                                                                           |
| In the news (last 90 days)        | Advanced | Companies with recent news of these kinds. Choices: Funding & Investment, Mergers & Acquisitions, Product Launch, Partnership, Expansion, Layoffs & Restructuring, IPO, Leadership Change, Legal & Regulatory, Awards & Recognition. |
| Similar to this company           | Options  | Finds companies like this one.                                                                                                                                                                                                       |
| Ideal customer, in words          | Advanced | Describe the companies you want; Prospeo finds lookalikes. Use this or Similar to this company.                                                                                                                                      |
| More filters (JSON)               | Advanced | Any other Prospeo filter by its documented name, e.g. company_intent, company_icp, company_attributes. Merged with the fields above.                                                                                                 |
| Page                              | Options  | 25 results per page, up to page 1000. Bind Next page from an earlier search to keep going. Default: 1.                                                                                                                               |

**Gives you:**

- **Matched** (yes or no)
- **Page** (number)
- **Total pages** (number)
- **Total count** (number)
- **Next page** (number)
- **Free** (yes or no)
- **People** (a list; each item has Person ID, Full name, Job title, LinkedIn URL, Has verified email, Has mobile, Company name, Company website and the full record)
- **Person IDs** (a list of text)

### Find a person's email

Verified work email (and optionally mobile) plus full profile and company for one person.

| Field                             | Where    | What to enter                                                                                                                                                  |
| --------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Person                            | Main     | Any one identifier is enough. Or leave this empty and use Name plus Company.                                                                                   |
| Name                              | Main     | Use with Company when you have no LinkedIn URL or email.                                                                                                       |
| Company                           | Main     | The company's website works best; a company name alone is the weakest match.                                                                                   |
| Also find a mobile number         | Options  | Costs extra, and only when a mobile number is found. The price note above shows how much.                                                                      |
| Only people with a verified email | Options  | Anyone without one counts as not found, and is not charged.                                                                                                    |
| Only people with a mobile number  | Advanced | Turns on mobile lookup. Anyone without a mobile counts as not found, and is not charged.                                                                       |
| If nothing is found               | Options  | Continue: the step returns Matched = no and nothing is charged, so you can branch on it. Stop: the run stops here. Choices: continue, stop. Default: continue. |

**Gives you:**

- **Matched** (yes or no)
- **Email** (text)
- **Email verified** (yes or no)
- **Mobile** (text)
- **Full name** (text)
- **Job title** (text)
- **LinkedIn URL** (text)
- **Company name** (text)
- **Company website** (text)
- **Free enrichment** (yes or no)
- **Person** (the full record, every field the provider returned)
- **Company** (the full record, every field the provider returned)

### Find emails in bulk

Emails (and optionally mobiles) for up to 50 people in one call. Only people found are charged.

| Field                             | Where    | What to enter                                                                                                                |
| --------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------- |
| People                            | Required | Up to 50. Each can be a LinkedIn URL, an email, a Prospeo person ID (map Person IDs from a search), or "Name @ company.com". |
| Also find a mobile number         | Options  | Costs extra, and only when a mobile number is found. The price note above shows how much.                                    |
| Only people with a verified email | Options  | Anyone without one counts as not found, and is not charged.                                                                  |
| Only people with a mobile number  | Advanced | Turns on mobile lookup. Anyone without a mobile counts as not found, and is not charged.                                     |

**Gives you:**

- **Results** (a list; each item has Matched, Email, Email verified, Mobile, Full name, Job title, LinkedIn URL, Company name, Company website, Free enrichment, Input and the full record)
- **Matched count** (number)
- **With email count** (number)
- **Credits used** (number)

### Search for companies

Find companies by location, industry, size, tech stack, funding, revenue, hiring and lookalikes. 25 per page.

| Field                           | Where    | What to enter                                                                                                                                                                                                                        |
| ------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Company websites                | Options  | Root domains only, no subdomains.                                                                                                                                                                                                    |
| Exclude company websites        | Options  | -                                                                                                                                                                                                                                    |
| Company names                   | Options  | -                                                                                                                                                                                                                                    |
| Company locations               | Main     | Where the company is based. Pick from the suggestions so the spelling matches. Suggestions appear as you type.                                                                                                                       |
| Exclude company locations       | Options  | Suggestions appear as you type.                                                                                                                                                                                                      |
| Industries                      | Main     | Suggestions appear as you type.                                                                                                                                                                                                      |
| Exclude industries              | Options  | Suggestions appear as you type.                                                                                                                                                                                                      |
| Company size                    | Main     | Choices: 1-10, 11-20, 21-50, 51-100, 101-200, 201-500, 501-1000, 1001-2000, 2001-5000, 5001-10000, 10000+.                                                                                                                           |
| Custom size: at least           | Advanced | Instead of the size ranges: employees at least this many.                                                                                                                                                                            |
| Custom size: at most            | Advanced | -                                                                                                                                                                                                                                    |
| Company keywords                | Main     | Words in the company's description, specialties or website. Up to 20.                                                                                                                                                                |
| Uses technologies               | Options  | Companies whose stack includes these. Up to 20. Suggestions appear as you type.                                                                                                                                                      |
| Does not use technologies       | Advanced | Suggestions appear as you type.                                                                                                                                                                                                      |
| Latest funding stage            | Options  | Choices: Pre seed, Seed, Angel, Series A, Series B, Series C, Series D, Series E-J, Series unknown, Private equity, Debt financing, Convertible note, Corporate round, Equity crowdfunding, and 9 more.                              |
| Raised money in the last (days) | Options  | Choices: 30, 60, 90, 180, 270, 365.                                                                                                                                                                                                  |
| Revenue at least (USD)          | Advanced | Choices: <100K, 100K, 500K, 1M, 5M, 10M, 25M, 50M, 100M, 250M, 500M, 1B, 5B, 10B+.                                                                                                                                                   |
| Revenue at most (USD)           | Advanced | Choices: <100K, 100K, 500K, 1M, 5M, 10M, 25M, 50M, 100M, 250M, 500M, 1B, 5B, 10B+.                                                                                                                                                   |
| Founded in or after             | Advanced | -                                                                                                                                                                                                                                    |
| Founded in or before            | Advanced | -                                                                                                                                                                                                                                    |
| Company type                    | Advanced | Choices: Private, Public, Non Profit, Other.                                                                                                                                                                                         |
| Email provider                  | Advanced | Companies whose mail runs on these providers. Choices: Google, Microsoft, Proofpoint, Mimecast, Other.                                                                                                                               |
| Hiring for                      | Options  | Job titles in the company's open postings.                                                                                                                                                                                           |
| In the news (last 90 days)      | Advanced | Companies with recent news of these kinds. Choices: Funding & Investment, Mergers & Acquisitions, Product Launch, Partnership, Expansion, Layoffs & Restructuring, IPO, Leadership Change, Legal & Regulatory, Awards & Recognition. |
| Similar to this company         | Options  | Finds companies like this one.                                                                                                                                                                                                       |
| Ideal customer, in words        | Advanced | Describe the companies you want; Prospeo finds lookalikes. Use this or Similar to this company.                                                                                                                                      |
| More filters (JSON)             | Advanced | Any other Prospeo filter by its documented name, e.g. company_intent, company_icp, company_attributes. Merged with the fields above.                                                                                                 |
| Page                            | Options  | 25 results per page, up to page 1000. Bind Next page from an earlier search to keep going. Default: 1.                                                                                                                               |

**Gives you:**

- **Matched** (yes or no)
- **Page** (number)
- **Total pages** (number)
- **Total count** (number)
- **Next page** (number)
- **Free** (yes or no)
- **Companies** (a list; each item has Name, Website, Domain, Industry, Employee count, LinkedIn URL and the full record)
- **Websites** (a list of text)

### Enrich a company

Firmographics for one company: size, industry, revenue, funding, tech stack, hiring, socials.

| Field               | Where    | What to enter                                                                                                                                                  |
| ------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Company             | Required | A website is the most reliable. A company name alone may match the wrong company.                                                                              |
| If nothing is found | Options  | Continue: the step returns Matched = no and nothing is charged, so you can branch on it. Stop: the run stops here. Choices: continue, stop. Default: continue. |

**Gives you:**

- **Matched** (yes or no)
- **Name** (text)
- **Website** (text)
- **Domain** (text)
- **Industry** (text)
- **Employee count** (number)
- **LinkedIn URL** (text)
- **Free enrichment** (yes or no)
- **Company** (the full record, every field the provider returned)

### Enrich companies in bulk

Firmographics for up to 50 companies in one call. Only matches are charged.

| Field     | Where    | What to enter                                               |
| --------- | -------- | ----------------------------------------------------------- |
| Companies | Required | Up to 50: websites, LinkedIn pages, or Prospeo company IDs. |

**Gives you:**

- **Results** (a list; each item has Matched, Name, Website, Domain, Industry, Employee count, LinkedIn URL, Free enrichment, Input and the full record)
- **Matched count** (number)
- **Credits used** (number)

### Look up filter values

Prospeo's exact spelling for locations, job titles, industries, technologies and more. Free.

| Field           | Where    | What to enter                                                                                                                       |
| --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| What to look up | Required | Choices: location, job_title, technology, industry, naics, sic, integration, investor, customer, product, service, award, language. |
| Starts with     | Required | -                                                                                                                                   |

**Gives you:**

- **Suggestions** (a list of text)
- **Items** (a list; each item has Value, Type, Code and the full record)

## Ports

- **Input: Input** (`in`): `any`, optional, multi_object.
- **Output: Success** (`success`): `object`, optional, single.
- **Output: Error** (`error`): `object`, optional, single.

## Inspector

- **Action panel:** choose the action and where each field's value comes from. See _Setting it up_ above for what it costs.

## Behavior

- **Input requirement:** Choose an action. Fields can come from earlier steps or be typed in.
- **Execution:** Runs through the platform's managed data provider connection; Edgaze is the customer, no account is involved on the runner's side.
- **Timeout:** 30000 ms by default (1000 to 120000 ms).

## Cost

Makes a metered third-party data call that Edgaze itself pays for; the action's price is included in the workflow's run price. The run reserves the action's maximum possible cost before it starts.

## Security

- No account is connected by anyone: Edgaze is the data provider's customer and calls it with the platform's own key. The per-call price is metered into the workflow's run price.
- Calls carry the platform's key only; no runner account, token, or personal data access is ever involved.

## Retry

A call is never retried by the engine, so a bug can never bill the same lookup twice. Answers the provider documents as never billed (rate limits, a temporarily unavailable service) are retried with backoff for up to about 30 seconds inside the single attempt; anything that might have been billed is not retried.

## Production checklist

- Test the happy path and one malformed or empty input.
- Keep credentials out of prompts and published graph configuration.
- Set a timeout that matches the operation's side effects.
- Name the final result so a runner can tell what success looks like.
