--- type: "firecrawl-provider" description: "Find a verified work email, enrich a person or company, and search people or companies." use_when: "Find a verified work email or mobile, enrich a person, or search for people.\n\nEnrich one company or search for companies." categories: "People" capabilities: 5 credits_per_record: 15 --- # Prospeo on Firecrawl Alexandria Find a verified work email, enrich a person or company, and search people or companies. - Categories: People - Category index: [People category](https://alexandria.firecrawl.dev/agents/categories/people) - Provider key: `prospeo` - Access: Firecrawl credits - Cost (Email finder): 15 credits per record - Cost (Person enrichment): 15 credits per record - Cost (People search): 15 credits per record - Cost (Company enrichment): 15 credits per record - Cost (Company search): 15 credits per record ## More - [Human guide](https://www.firecrawl.dev/app/alexandria/prospeo) - [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/prospeo/openapi.json) ## Capabilities - [Email finder](https://alexandria.firecrawl.dev/agents/providers/prospeo/people/email-find): One person and their current company. person.email.email is the verified address. - [Person enrichment](https://alexandria.firecrawl.dev/agents/providers/prospeo/people/enrich): One person and their current company. person.email.revealed is false or null when no email was returned. - [People search](https://alexandria.firecrawl.dev/agents/providers/prospeo/people/search): Up to 25 entries, each with person and company. pagination has current_page, per_page, total_page, and total_count. free is true on a deduplicated page. - [Company enrichment](https://alexandria.firecrawl.dev/agents/providers/prospeo/companies/enrich): One company. Unavailable fields are null. - [Company search](https://alexandria.firecrawl.dev/agents/providers/prospeo/companies/search): Up to 25 entries, each with a company object. pagination has current_page, per_page, total_page, and total_count. free is true on a deduplicated page. ## 1. Choose this provider when Find a verified work email or mobile, enrich a person, or search for people. Enrich one company or search for companies. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "prospeo", "capability": "people/email-find", "options": { "first_name": "" } } ``` ## 3. Add provider options Use only the options needed for the task: - `first_name` (string): Given name. Send with last_name and a company datapoint. Example: `` - `last_name` (string): Family name. Send with first_name and a company datapoint. Example: `` - `full_name` (string): Full name, when first and last are not split. Send with a company datapoint. Example: `` - `linkedin_url` (string): Public LinkedIn profile URL. Enough on its own. Example: `` - `company_name` (string): Employer name. Prefer company_website; many companies share a name. Example: `` - `company_website` (string): Employer website, such as intercom.com. Example: `` - `company_linkedin_url` (string): Employer LinkedIn company URL. Example: `` - `person_id` (string): person_id from people/search. Enough on its own. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "prospeo", capability: "people/email-find", options: { first_name: "", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "prospeo", "capability": "people/email-find", "options": { "first_name": "" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "prospeo", "capability": "people/email-find", "options": { "first_name": "" } } }' ``` ### CLI ```sh firecrawl scrape 'prospeo/people/email-find' \ --options '{"first_name":""}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "prospeo", "capability": "people/email-find", "options": { "first_name": "" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "prospeo", "capability": "people/email-find", "options": { "first_name": "" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "error": false, "free_enrichment": false, "person": {}, "company": {} } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Email finder - Capability: `people/email-find` - Description: One person and their current company. person.email.email is the verified address. - Instructions: Find one person's verified work email from a LinkedIn URL, a person_id, or a name plus company website, name, or LinkedIn URL. Returns only when the email is VERIFIED. 25 Firecrawl credits when an email comes back; no match, or a record already enriched within 90 days, costs nothing. - Cost: 15 credits per record - Capability file: [Email finder](https://alexandria.firecrawl.dev/agents/providers/prospeo/people/email-find) Accepted options: - `first_name` (string): Given name. Send with last_name and a company datapoint. Example: `` - `last_name` (string): Family name. Send with first_name and a company datapoint. Example: `` - `full_name` (string): Full name, when first and last are not split. Send with a company datapoint. Example: `` - `linkedin_url` (string): Public LinkedIn profile URL. Enough on its own. Example: `` - `company_name` (string): Employer name. Prefer company_website; many companies share a name. Example: `` - `company_website` (string): Employer website, such as intercom.com. Example: `` - `company_linkedin_url` (string): Employer LinkedIn company URL. Example: `` - `person_id` (string): person_id from people/search. Enough on its own. Example: `` Response schema example: ```json { "error": false, "free_enrichment": false, "person": {}, "company": {} } ``` ### Person enrichment - Capability: `people/enrich` - Description: One person and their current company. person.email.revealed is false or null when no email was returned. - Instructions: Fill in a person's profile, current employer, and any available work email from a LinkedIn URL, email, person_id, or a name plus company. Never reveals a mobile. 25 Firecrawl credits for a matched person; no match, or a record already enriched within 90 days, costs nothing. - Cost: 15 credits per record - Capability file: [Person enrichment](https://alexandria.firecrawl.dev/agents/providers/prospeo/people/enrich) Accepted options: - `first_name` (string): Given name. Send with last_name and a company datapoint. Example: `` - `last_name` (string): Family name. Send with first_name and a company datapoint. Example: `` - `full_name` (string): Full name, when first and last are not split. Send with a company datapoint. Example: `` - `linkedin_url` (string): Public LinkedIn profile URL. Enough on its own. Example: `` - `company_name` (string): Employer name. Prefer company_website; many companies share a name. Example: `` - `company_website` (string): Employer website, such as intercom.com. Example: `` - `company_linkedin_url` (string): Employer LinkedIn company URL. Example: `` - `person_id` (string): person_id from people/search. Enough on its own. Example: `` - `email` (string): Work email of the person. Enough on its own. Example: `` Response schema example: ```json { "error": false, "free_enrichment": false, "person": {}, "company": {} } ``` ### People search - Capability: `people/search` - Description: Up to 25 entries, each with person and company. pagination has current_page, per_page, total_page, and total_count. free is true on a deduplicated page. - Instructions: Build a lead list from Prospeo's people database with person, role, company, and location filters. 25 people per page, without emails or mobiles; pass person_id to people/email-find. 25 Firecrawl credits per page with results, however many people it holds (1 to 25); no results, or a page already paid for within 30 days, costs nothing. - Cost: 15 credits per record - Capability file: [People search](https://alexandria.firecrawl.dev/agents/providers/prospeo/people/search) Accepted options: - `filters` (object, required): Prospeo's native filter object, as in https://prospeo.io/api-docs/filters-documentation. Use exact values; the search-suggestions route is not part of this provider. Example: `{}` - `page` (number): Page number, 1 to 1,000. 25 results per page. Prospeo's default is 1. Example: `10` Response schema example: ```json { "results": [ { "person": {}, "company": {} } ] } ``` ### Company enrichment - Capability: `companies/enrich` - Description: One company. Unavailable fields are null. - Instructions: Enrich one company with firmographics, funding, technology, and hiring data from its website, LinkedIn URL, name, or company_id. 25 Firecrawl credits for a matched company; no match, or a company already enriched within 90 days, costs nothing. - Cost: 15 credits per record - Capability file: [Company enrichment](https://alexandria.firecrawl.dev/agents/providers/prospeo/companies/enrich) Accepted options: - `company_website` (string): Company website, such as intercom.com. The most accurate match. Example: `` - `company_linkedin_url` (string): LinkedIn company URL. Example: `` - `company_name` (string): Company name. Many companies share a name, so send a website too when you can. Example: `` - `company_id` (string): company_id from an earlier Prospeo company object. Example: `` Response schema example: ```json { "error": false, "free_enrichment": false, "company": {} } ``` ### Company search - Capability: `companies/search` - Description: Up to 25 entries, each with a company object. pagination has current_page, per_page, total_page, and total_count. free is true on a deduplicated page. - Instructions: Build an account list from Prospeo's company database with firmographic, funding, technology, and growth filters. 25 companies per page. 25 Firecrawl credits per page with results, however many companies it holds (1 to 25); no results, or a page already paid for within 30 days, costs nothing. - Cost: 15 credits per record - Capability file: [Company search](https://alexandria.firecrawl.dev/agents/providers/prospeo/companies/search) Accepted options: - `filters` (object, required): Prospeo's native filter object, as in https://prospeo.io/api-docs/filters-documentation. Use exact values; the search-suggestions route is not part of this provider. Example: `{}` - `page` (number): Page number, 1 to 1,000. 25 results per page. Prospeo's default is 1. Example: `10` Response schema example: ```json { "results": [ { "company": {} } ] } ```