--- type: "firecrawl-provider" description: "Verify an email, find a work email, and enrich a company from its domain or LinkedIn page." use_when: "Verify one email address, or find a work email from a LinkedIn profile or a name and domain.\n\nEnrich one company from its domain or LinkedIn company page." categories: "People" capabilities: 3 credits_per_call: 5 --- # OrbiSearch on Firecrawl Alexandria Verify an email, find a work email, and enrich a company from its domain or LinkedIn page. - Categories: People - Category index: [People category](https://alexandria.firecrawl.dev/agents/categories/people) - Provider key: `orbisearch` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://www.firecrawl.dev/app/alexandria/orbisearch) - [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/orbisearch/openapi.json) ## Capabilities - [Email verifier](https://alexandria.firecrawl.dev/agents/providers/orbisearch/people/email-verify): One verification. status is safe, risky, invalid, or unknown. confidence is 0 to 100, or null when no score was attached. - [Email finder](https://alexandria.firecrawl.dev/agents/providers/orbisearch/people/email-find): One result. status is safe with email set when a deliverable address was found, or unknown with email null; substatus then says no_address_found, timeout, profile_not_found, no_current_employer, or no_company_website. credits_consumed is the vendor charge. - [Company enrichment](https://alexandria.firecrawl.dev/agents/providers/orbisearch/companies/enrich): One company. result is found or not_found; on not_found every data field is null. is_redirect and redirected_to describe a domain that redirects. ## 1. Choose this provider when Verify one email address, or find a work email from a LinkedIn profile or a name and domain. Enrich one company from its domain or LinkedIn company page. ## 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": "orbisearch", "capability": "people/email-verify", "options": { "email": "" } } ``` ## 3. Add provider options Use only the options needed for the task: - `email` (string, required): The address to verify. Example: `` - `timeout` (number): Seconds OrbiSearch may spend, from 3 to 97. OrbiSearch's default is 97. Example: `10` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "orbisearch", capability: "people/email-verify", options: { email: "", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "orbisearch", "capability": "people/email-verify", "options": { "email": "" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "orbisearch", "capability": "people/email-verify", "options": { "email": "" } } }' ``` ### CLI ```sh firecrawl scrape 'orbisearch/people/email-verify' \ --options '{"email":""}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "orbisearch", "capability": "people/email-verify", "options": { "email": "" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "orbisearch", "capability": "people/email-verify", "options": { "email": "" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "email": "", "status": "", "substatus": "", "explanation": "", "confidence": 0, "email_provider": "", "mx_record": "", "is_domain_catch_all": false, "is_secure_email_gateway": false, "is_disposable": false, "is_role_account": false, "is_free": false } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Email verifier - Capability: `people/email-verify` - Description: One verification. status is safe, risky, invalid, or unknown. confidence is 0 to 100, or null when no score was attached. - Instructions: Check whether an email address you already have is deliverable. status is safe, risky, invalid, or unknown, with a substatus such as catch_all or mailbox_not_found. 5 Firecrawl credits per call, whatever the verdict. Use people/email-find to find an address. - Cost: 5 credits per call - Capability file: [Email verifier](https://alexandria.firecrawl.dev/agents/providers/orbisearch/people/email-verify) Accepted options: - `email` (string, required): The address to verify. Example: `` - `timeout` (number): Seconds OrbiSearch may spend, from 3 to 97. OrbiSearch's default is 97. Example: `10` Response schema example: ```json { "email": "", "status": "", "substatus": "", "explanation": "", "confidence": 0, "email_provider": "", "mx_record": "", "is_domain_catch_all": false, "is_secure_email_gateway": false, "is_disposable": false, "is_role_account": false, "is_free": false } ``` ### Email finder - Capability: `people/email-find` - Description: One result. status is safe with email set when a deliverable address was found, or unknown with email null; substatus then says no_address_found, timeout, profile_not_found, no_current_employer, or no_company_website. credits_consumed is the vendor charge. - Instructions: Find one person's work email from a LinkedIn profile URL, or from a name and company domain. 5 Firecrawl credits per call, including status unknown with a null email, because OrbiSearch charges every returned search. Use people/email-verify when you already have the address. - Cost: 5 credits per call - Capability file: [Email finder](https://alexandria.firecrawl.dev/agents/providers/orbisearch/people/email-find) Accepted options: - `linkedin_url` (string): LinkedIn profile URL. Send alone, instead of a name and domain. Example: `` - `first_name` (string): Given name. Send with domain; at least one name part is needed. Example: `` - `last_name` (string): Family name. Send with domain; at least one name part is needed. Example: `` - `domain` (string): Company domain, such as acme.com. Required unless linkedin_url is sent. Example: `` - `timeout` (number): Seconds OrbiSearch may search, from 30 to 97. OrbiSearch's default is 97. Example: `30` Response schema example: ```json { "email": "", "first_name": "", "last_name": "", "full_name": "", "domain": "", "email_domain": "", "linkedin_url": "", "employer_name": "", "employer_linkedin_url": "", "all_emails": [], "status": "", "substatus": "", "explanation": "", "confidence": 0, "email_provider": "", "mx_record": "", "is_domain_catch_all": false, "is_secure_email_gateway": false, "is_disposable": false, "is_role_account": false, "is_free": false, "credits_consumed": 0 } ``` ### Company enrichment - Capability: `companies/enrich` - Description: One company. result is found or not_found; on not_found every data field is null. is_redirect and redirected_to describe a domain that redirects. - Instructions: Get firmographics for one company from its domain or LinkedIn company URL: industry, size, employee count, headquarters, founded year, specialties, and similar companies. 5 Firecrawl credits per call, including result not_found. - Cost: 5 credits per call - Capability file: [Company enrichment](https://alexandria.firecrawl.dev/agents/providers/orbisearch/companies/enrich) Accepted options: - `domain` (string): Company website domain, such as kearney.com. A full URL is reduced to its domain. Example: `` - `linkedin_url` (string): LinkedIn company or showcase page. Preferred when you have it. Not a numeric company URL. Example: `` Response schema example: ```json { "result": "", "input": "", "name": "", "description": "", "website": "", "domain": "", "linkedin_url": "", "industry": "", "company_size": {}, "employee_count": 0, "company_type": "", "headquarters": {}, "founded_year": 0, "specialties": [], "follower_count": 0, "similar_companies": [], "credits_consumed": 0 } ```