--- type: "firecrawl-provider" description: "Search business contacts, enrich one person, and read funding and acquisition news." use_when: "Search and count business contacts, list colleagues and decision makers at a company, and enrich one person from an email, LinkedIn profile, name and company, or phone number.\n\nRecent funding rounds and acquisitions extracted from news." categories: "People" capabilities: 6 pricing: "5 credits per billed unit; see each capability for its unit and maximum." --- # GetLeads.io on Firecrawl Alexandria Search business contacts, enrich one person, and read funding and acquisition news. - Categories: People - Category index: [People category](https://alexandria.firecrawl.dev/agents/categories/people) - Provider key: `getleadsio` - Access: Firecrawl credits - Cost (Contact search): 5 credits per call - Cost (Person from email): 5 credits per person found - Cost (Person from LinkedIn): 5 credits per person found - Cost (Person from name and company): 5 credits per person found - Cost (Funding announcements): 5 credits per call - Cost (Acquisition announcements): 5 credits per call ## More - [Human guide](https://www.firecrawl.dev/app/alexandria/getleadsio) - [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/getleadsio/openapi.json) ## Capabilities - [Contact search](https://alexandria.firecrawl.dev/agents/providers/getleadsio/people/search): contacts is the page. returned and total_available size the page and the match set. Advance with next_offset while has_more is true; next_offset is null on the last page. An empty page is still billed. - [Person from email](https://alexandria.firecrawl.dev/agents/providers/getleadsio/people/enrich-email): results holds exactly one entry, for the one input sent. success false is a miss and costs nothing. - [Person from LinkedIn](https://alexandria.firecrawl.dev/agents/providers/getleadsio/people/enrich-linkedin): results holds exactly one entry, for the one input sent. success false is a miss and costs nothing. - [Person from name and company](https://alexandria.firecrawl.dev/agents/providers/getleadsio/people/enrich-person): results holds exactly one entry, for the one input sent. success false is a miss and costs nothing. - [Funding announcements](https://alexandria.firecrawl.dev/agents/providers/getleadsio/companies/funding): data holds the announcements, newest first. count is the page length. An empty list is still billed. - [Acquisition announcements](https://alexandria.firecrawl.dev/agents/providers/getleadsio/companies/acquisitions): data holds the announcements, with acquirer, target, amount, and source when present. count is the page length. An empty list is still billed. ## 1. Choose this provider when Search and count business contacts, list colleagues and decision makers at a company, and enrich one person from an email, LinkedIn profile, name and company, or phone number. Recent funding rounds and acquisitions extracted from news. ## 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": "getleadsio", "capability": "people/search", "options": { "filters": {}, "limit": 25 } } ``` ## 3. Add provider options Use only the options needed for the task: - `filters` (object, required): Search filters, such as { "domains": ["stripe.com"], "email_status": ["VALID"] } or { "countries": ["Ireland"], "seniority": ["C-Team"] }. Role, company, industry, technology, geography, email-quality, hiring, funding, revenue, headcount, and exclusion filters are documented by GetLeads.io. Different fields combine with AND; values in one list combine with OR. Example: `{}` - `limit` (number): Contacts on this page, from 1 to 100. Defaults to 25. Example: `25` - `offset` (number): Offset from the previous page's next_offset. Walks past 50,000 matches are not reliable. Example: `10` - `max_per_company` (number): Most contacts one company can fill on the page, from 1 to 50. Example: `10` - `columns` (string[]): Fields to return. Omit for GetLeads.io's default selection. Example: `[]` - `where_sql` (string): Optional advanced predicate over GetLeads.io's columns, at most 4000 characters, combined with filters. Prefer filters. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "getleadsio", capability: "people/search", options: { filters: {}, limit: 25, }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "getleadsio", "capability": "people/search", "options": { "filters": {}, "limit": 25 } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "getleadsio", "capability": "people/search", "options": { "filters": {}, "limit": 25 } } }' ``` ### CLI ```sh firecrawl scrape 'getleadsio/people/search' \ --options '{"filters":{},"limit":25}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "getleadsio", "capability": "people/search", "options": { "filters": {}, "limit": 25 } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "getleadsio", "capability": "people/search", "options": { "filters": {}, "limit": 25 } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "contacts": [ { "first_name": "", "last_name": "", "job_title": "", "company_name": "", "email": "", "email_status": "", "linkedin_url": "" } ] } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Contact search - Capability: `people/search` - Description: contacts is the page. returned and total_available size the page and the match set. Advance with next_offset while has_more is true; next_offset is null on the last page. An empty page is still billed. - Instructions: Find business contacts by company domain, role, seniority, location, industry, email status, hiring, or funding filters, 100 per page at most. 5 credits per successful call, including an empty page. total_available sizes the match set; use next_offset to page. Personal email lists are dropped. - Cost: 5 credits per call - Capability file: [Contact search](https://alexandria.firecrawl.dev/agents/providers/getleadsio/people/search) Accepted options: - `filters` (object, required): Search filters, such as { "domains": ["stripe.com"], "email_status": ["VALID"] } or { "countries": ["Ireland"], "seniority": ["C-Team"] }. Role, company, industry, technology, geography, email-quality, hiring, funding, revenue, headcount, and exclusion filters are documented by GetLeads.io. Different fields combine with AND; values in one list combine with OR. Example: `{}` - `limit` (number): Contacts on this page, from 1 to 100. Defaults to 25. Example: `25` - `offset` (number): Offset from the previous page's next_offset. Walks past 50,000 matches are not reliable. Example: `10` - `max_per_company` (number): Most contacts one company can fill on the page, from 1 to 50. Example: `10` - `columns` (string[]): Fields to return. Omit for GetLeads.io's default selection. Example: `[]` - `where_sql` (string): Optional advanced predicate over GetLeads.io's columns, at most 4000 characters, combined with filters. Prefer filters. Example: `` Response schema example: ```json { "contacts": [ { "first_name": "", "last_name": "", "job_title": "", "company_name": "", "email": "", "email_status": "", "linkedin_url": "" } ] } ``` ### Person from email - Capability: `people/enrich-email` - Description: results holds exactly one entry, for the one input sent. success false is a miss and costs nothing. - Instructions: Look up the person, title, company, and LinkedIn profile behind one email address. 5 credits when a person comes back. A miss (success false) costs nothing. GetLeads.io may report success for an address it cannot verify, so check the returned email. - Cost: 5 credits per person found - Capability file: [Person from email](https://alexandria.firecrawl.dev/agents/providers/getleadsio/people/enrich-email) Accepted options: - `email` (string, required): One work or personal email address. Example: `` Response schema example: ```json { "results": { "input": {}, "success": false, "data": {} } } ``` ### Person from LinkedIn - Capability: `people/enrich-linkedin` - Description: results holds exactly one entry, for the one input sent. success false is a miss and costs nothing. - Instructions: Look up the work email, title, and company for one LinkedIn person profile. 5 credits when a person comes back. A miss (success false) costs nothing. - Cost: 5 credits per person found - Capability file: [Person from LinkedIn](https://alexandria.firecrawl.dev/agents/providers/getleadsio/people/enrich-linkedin) Accepted options: - `linkedin_url` (string, required): One LinkedIn person profile URL, such as https://www.linkedin.com/in/example. Example: `` Response schema example: ```json { "results": { "input": {}, "success": false, "data": {} } } ``` ### Person from name and company - Capability: `people/enrich-person` - Description: results holds exactly one entry, for the one input sent. success false is a miss and costs nothing. - Instructions: Find one person's work email, title, and LinkedIn profile from their name and company name or email domain. 5 credits when a person comes back. A miss (success false) costs nothing. - Cost: 5 credits per person found - Capability file: [Person from name and company](https://alexandria.firecrawl.dev/agents/providers/getleadsio/people/enrich-person) Accepted options: - `first_name` (string, required): First name. Example: `` - `last_name` (string, required): Last name. Example: `` - `company_name` (string): Current employer's name. Send this or email_domain. Example: `` - `email_domain` (string): Employer's email domain, such as stripe.com. Send this or company_name. Example: `` Response schema example: ```json { "results": { "input": {}, "success": false, "data": {} } } ``` ### Funding announcements - Capability: `companies/funding` - Description: data holds the announcements, newest first. count is the page length. An empty list is still billed. - Instructions: List recent startup and company funding rounds extracted from news: company, round, amount, currency, region, and date. 5 credits per successful call, including an empty list. Each call reads the feeds live and can take 15 to 45 seconds. - Cost: 5 credits per call - Capability file: [Funding announcements](https://alexandria.firecrawl.dev/agents/providers/getleadsio/companies/funding) Accepted options: - `limit` (number): Announcements to return, from 1 to 100. Defaults to 25. Example: `25` - `since` (string): Earliest announcement date, YYYY-MM-DD. Example: `` - `min_confidence` (number): Lowest extraction confidence to keep, from 0 to 1. GetLeads.io defaults to 0.5. Example: `1` - `region` (string): News region: US, EU, or GLOBAL. Example: `US` Response schema example: ```json { "data": [ { "company_name": "", "round": "", "amount": 0, "currency": "", "announced_date": "", "region": "", "confidence": 0 } ] } ``` ### Acquisition announcements - Capability: `companies/acquisitions` - Description: data holds the announcements, with acquirer, target, amount, and source when present. count is the page length. An empty list is still billed. - Instructions: List recent acquisitions extracted from news, optionally by acquirer, target, or disclosed amount. 5 credits per successful call, including an empty list. Each call reads the feeds live. - Cost: 5 credits per call - Capability file: [Acquisition announcements](https://alexandria.firecrawl.dev/agents/providers/getleadsio/companies/acquisitions) Accepted options: - `limit` (number): Announcements to return, from 1 to 100. Defaults to 25. Example: `25` - `since` (string): Earliest announcement date, YYYY-MM-DD. Example: `` - `min_confidence` (number): Lowest extraction confidence to keep, from 0 to 1. GetLeads.io defaults to 0.5. Example: `1` - `acquirer` (string): Keep announcements whose acquirer matches this name. Example: `` - `target` (string): Keep announcements whose acquired company matches this name. Example: `` - `has_amount` (boolean): When true, keep only announcements with a disclosed amount. Example: `false` - `min_amount` (number): Lowest disclosed amount to keep. Example: `10` Response schema example: ```json { "data": [ { "acquirer": "", "target": "", "amount": 0, "currency": "", "announced_date": "", "confidence": 0 } ] } ```