--- type: "firecrawl-provider" description: "Find a verified work email by name, and look up companies, their technologies, and lookalikes." use_when: "Find a verified work email or phone, resolve an email to a profile, or find people by role or job title.\n\nCompany information, the technologies on a domain, and lookalike companies." categories: "People" capabilities: 4 pricing: "2–10 credits per billed unit; see each capability for its unit and maximum." --- # Findymail on Firecrawl Alexandria Find a verified work email by name, and look up companies, their technologies, and lookalikes. - Categories: People - Category index: [People category](https://alexandria.firecrawl.dev/agents/categories/people) - Provider key: `findymail` - Access: Firecrawl credits - Cost (Email finder by name): 10 credits per record - Cost (Company information): 10 credits per record - Cost (Technologies by domain): 10 credits per record - Cost (Lookalike companies): 2 credits per 10 companies returned ## More - [Human guide](https://www.firecrawl.dev/app/alexandria/findymail) - [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/findymail/openapi.json) ## Capabilities - [Email finder by name](https://alexandria.firecrawl.dev/agents/providers/findymail/people/email-find): One contact, or null on a miss. - [Company information](https://alexandria.firecrawl.dev/agents/providers/findymail/companies/enrich): One company. - [Technologies by domain](https://alexandria.firecrawl.dev/agents/providers/findymail/companies/technologies): domain, and technologies with name, category, subcategory, and last_detected_at. - [Lookalike companies](https://alexandria.firecrawl.dev/agents/providers/findymail/companies/similar): companies, total, and credits_used (Findymail finder credits). ## 1. Choose this provider when Find a verified work email or phone, resolve an email to a profile, or find people by role or job title. Company information, the technologies on a domain, and lookalike 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": "findymail", "capability": "people/email-find", "options": { "name": "", "domain": "" } } ``` ## 3. Add provider options Use only the options needed for the task: - `name` (string, required): The person's full name, such as Patrick Collison. Example: `` - `domain` (string, required): Company domain, such as stripe.com. No scheme or path. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "findymail", capability: "people/email-find", options: { name: "", domain: "", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "findymail", "capability": "people/email-find", "options": { "name": "", "domain": "" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "findymail", "capability": "people/email-find", "options": { "name": "", "domain": "" } } }' ``` ### CLI ```sh firecrawl scrape 'findymail/people/email-find' \ --options '{"name":"","domain":""}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "findymail", "capability": "people/email-find", "options": { "name": "", "domain": "" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "findymail", "capability": "people/email-find", "options": { "name": "", "domain": "" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "contact": { "email": "", "name": "", "domain": "", "id": 0, "company": "", "linkedin_url": "", "job_title": "", "city": "", "region": "", "country": "", "company_city": "", "company_region": "", "company_country": "" } } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Email finder by name - Capability: `people/email-find` - Description: One contact, or null on a miss. - Instructions: Find one person's verified work email from their full name and company domain. 20 Firecrawl credits when an email comes back; a miss costs nothing. The returned domain can be an alias of the one asked for. Use people/email-find-by-profile when you have a profile URL instead. - Cost: 10 credits per record - Capability file: [Email finder by name](https://alexandria.firecrawl.dev/agents/providers/findymail/people/email-find) Accepted options: - `name` (string, required): The person's full name, such as Patrick Collison. Example: `` - `domain` (string, required): Company domain, such as stripe.com. No scheme or path. Example: `` Response schema example: ```json { "contact": { "email": "", "name": "", "domain": "", "id": 0, "company": "", "linkedin_url": "", "job_title": "", "city": "", "region": "", "country": "", "company_city": "", "company_region": "", "company_country": "" } } ``` ### Company information - Capability: `companies/enrich` - Description: One company. - Instructions: Firmographics for one company from its domain, name, or profile URL: size, industry, description, and location. 20 Firecrawl credits when a company comes back; not found costs nothing. - Cost: 10 credits per record - Capability file: [Company information](https://alexandria.firecrawl.dev/agents/providers/findymail/companies/enrich) Accepted options: - `domain` (string): Company domain, such as stripe.com. Example: `` - `name` (string): Company name. Example: `` - `linkedin_url` (string): Company profile URL. Example: `` Response schema example: ```json { "name": "", "domain": "", "company_size": "", "industry": "", "linkedin_url": "", "description": "", "city": "", "region": "", "country": "" } ``` ### Technologies by domain - Capability: `companies/technologies` - Description: domain, and technologies with name, category, subcategory, and last_detected_at. - Instructions: The technologies detected on a company's domain, each with category, subcategory, and last-detected time. Pass technologies to check for specific products. 20 Firecrawl credits when technologies come back; an unknown domain costs nothing. - Cost: 10 credits per record - Capability file: [Technologies by domain](https://alexandria.firecrawl.dev/agents/providers/findymail/companies/technologies) Accepted options: - `domain` (string, required): Company domain, such as stripe.com. Example: `` - `technologies` (string[]): Only report these exact technology names, such as Salesforce. Example: `[]` Response schema example: ```json { "technologies": [ { "name": "", "category": "", "subcategory": "", "last_detected_at": "" } ] } ``` ### Lookalike companies - Capability: `companies/similar` - Description: companies, total, and credits_used (Findymail finder credits). - Instructions: Companies similar to a seed domain, optionally in the same country or headcount band. 20 Firecrawl credits per started group of 10 companies returned, up to 100 per call; none returned costs nothing. - Cost: 2 credits per 10 companies returned - Capability file: [Lookalike companies](https://alexandria.firecrawl.dev/agents/providers/findymail/companies/similar) Accepted options: - `seed` (string, required): Seed company domain, such as stripe.com. Example: `` - `same_country` (boolean): Only companies in the seed's country. Example: `false` - `same_size` (boolean): Only companies in the seed's headcount band. Example: `false` - `limit` (number): Companies to return, 1 to 100. Each started group of 10 is billed. Example: `100` Response schema example: ```json { "companies": [ { "domain": "", "name": "", "linkedin_url": "", "company_size": "", "country": "" } ] } ```