--- type: "firecrawl-provider" description: "Company and person enrichment and search, employees and founders, and work email find, plus historical company financing: a company's full funding round history back to its first round (dates, stages, amounts, valuations, lead and other investors), every investor in a company, an investor's portfolio of companies, and a company's acquisitions with prices." use_when: "Enrich or search companies, and list employees, founders, full funding round history with investors, investments received, an investor's portfolio, and acquisitions.\n\nEnrich a person, search people, and reveal an email or phone number." categories: "People" capabilities: 11 pricing: "2–65 credits per billed unit; see each capability for its unit and maximum." --- # Aviato on Firecrawl Alexandria Company and person enrichment and search, employees and founders, and work email find, plus historical company financing: a company's full funding round history back to its first round (dates, stages, amounts, valuations, lead and other investors), every investor in a company, an investor's portfolio of companies, and a company's acquisitions with prices. - Categories: People - Category index: [People category](https://alexandria.firecrawl.dev/agents/categories/people) - Provider key: `aviato` - Access: Firecrawl credits - Cost (Company enrichment): 65 credits per paid company enrich - Cost (Company search): 2 credits per call - Cost (Company employees): 3 credits per call - Cost (Company founders): 5 credits per call - Cost (Funding rounds): 5 credits per call - Cost (Acquisitions): 10 credits per call - Cost (Investments received): 5 credits per call - Cost (Investments made): 5 credits per call - Cost (Person enrichment): 25 credits per person enrich - Cost (People search): 2 credits per call - Cost (Email finder): 35 credits per record ## More - [Human guide](https://www.firecrawl.dev/app/alexandria/aviato) - [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/aviato/openapi.json) ## Capabilities - [Company enrichment](https://alexandria.firecrawl.dev/agents/providers/aviato/companies/enrich): One company. Preview returns id, name, and URLs. A paid record adds description, location, industry, and headcount, and full=true adds financing. - [Company search](https://alexandria.firecrawl.dev/agents/providers/aviato/companies/search): items is the page of companies. count.value is the total, and count.isEstimate says whether that total is estimated. An empty items array is still a billed call. - [Company employees](https://alexandria.firecrawl.dev/agents/providers/aviato/companies/employees): Records in employees. The body also has pages and totalResults for the whole list. An empty page is still billed. The call is accepted only when employees is an array and pages and totalResults are numbers. - [Company founders](https://alexandria.firecrawl.dev/agents/providers/aviato/companies/founders): Records in founders. The body also has pages and totalResults for the whole list. An empty page is still billed. The call is accepted only when founders is an array and pages and totalResults are numbers. - [Funding rounds](https://alexandria.firecrawl.dev/agents/providers/aviato/companies/funding-rounds): Every funding round on record for one company, with its date, stage, amount, valuation and investors. Records in fundingRounds. The body also has pages and totalResults for the whole list. An empty page is still billed. The call is accepted only when fundingRounds is an array and pages and totalResults are numbers. - [Acquisitions](https://alexandria.firecrawl.dev/agents/providers/aviato/companies/acquisitions): Every acquisition the company made, with its date, price and the acquired company. Records in acquisitions. The body also has pages and totalResults for the whole list. An empty page is still billed. The call is accepted only when acquisitions is an array and pages and totalResults are numbers. - [Investments received](https://alexandria.firecrawl.dev/agents/providers/aviato/companies/investments): One row per investor and investment into the company. Records in investments. The body also has pages and totalResults for the whole list. An empty page is still billed. The call is accepted only when investments is an array and pages and totalResults are numbers. - [Investments made](https://alexandria.firecrawl.dev/agents/providers/aviato/companies/investments-outbound): One row per portfolio company investment the investor made. Records in investments. The body also has pages and totalResults for the whole list. An empty page is still billed. The call is accepted only when investments is an array and pages and totalResults are numbers. - [Person enrichment](https://alexandria.firecrawl.dev/agents/providers/aviato/people/enrich): One person. Preview is the short record. A paid record adds headline, location, skills, and experience. - [People search](https://alexandria.firecrawl.dev/agents/providers/aviato/people/search): items is the page of people. count.value is the total. An empty items array is still a billed call. - [Email finder](https://alexandria.firecrawl.dev/agents/providers/aviato/people/email-find): emails is the list. An empty list costs nothing. ## 1. Choose this provider when Enrich or search companies, and list employees, founders, full funding round history with investors, investments received, an investor's portfolio, and acquisitions. Enrich a person, search people, and reveal an email or phone number. ## 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": "aviato", "capability": "companies/enrich", "options": { "id": "" } } ``` ## 3. Add provider options Use only the options needed for the task: - `id` (string): Aviato company id. Example: `` - `linkedinID` (string): LinkedIn company slug. Example: `` - `linkedinNumID` (string): Numeric LinkedIn company id. Example: `` - `linkedinURL` (string): Company LinkedIn URL. Example: `` - `website` (string): Company domain or URL, such as stripe.com. Example: `` - `preview` (boolean): Return id, name, and URLs without a charge. Leave unset for the paid record. Example: `false` - `full` (boolean): Include funding, investments, acquisitions, and founders on the paid record. Example: `false` - `require` (string[]): Fields that must be present. A miss on one of them is a free 404. Example: `[]` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "aviato", capability: "companies/enrich", options: { id: "", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "aviato", "capability": "companies/enrich", "options": { "id": "" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "aviato", "capability": "companies/enrich", "options": { "id": "" } } }' ``` ### CLI ```sh firecrawl scrape 'aviato/companies/enrich' \ --options '{"id":""}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "aviato", "capability": "companies/enrich", "options": { "id": "" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "aviato", "capability": "companies/enrich", "options": { "id": "" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "id": "", "name": "", "description": "", "country": "", "region": "", "locality": "", "URLs": {}, "industryList": [], "headcount": 0 } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Company enrichment - Capability: `companies/enrich` - Description: One company. Preview returns id, name, and URLs. A paid record adds description, location, industry, and headcount, and full=true adds financing. - Instructions: Enrich a company from a domain, an Aviato id, or a LinkedIn URL. preview=true is free. A paid record with a name costs 100 credits, the quote ceiling for this 15-credit vendor call. A 404 costs nothing. - Cost: 65 credits per paid company enrich - Capability file: [Company enrichment](https://alexandria.firecrawl.dev/agents/providers/aviato/companies/enrich) Accepted options: - `id` (string): Aviato company id. Example: `` - `linkedinID` (string): LinkedIn company slug. Example: `` - `linkedinNumID` (string): Numeric LinkedIn company id. Example: `` - `linkedinURL` (string): Company LinkedIn URL. Example: `` - `website` (string): Company domain or URL, such as stripe.com. Example: `` - `preview` (boolean): Return id, name, and URLs without a charge. Leave unset for the paid record. Example: `false` - `full` (boolean): Include funding, investments, acquisitions, and founders on the paid record. Example: `false` - `require` (string[]): Fields that must be present. A miss on one of them is a free 404. Example: `[]` Response schema example: ```json { "id": "", "name": "", "description": "", "country": "", "region": "", "locality": "", "URLs": {}, "industryList": [], "headcount": 0 } ``` ### Company search - Capability: `companies/search` - Description: items is the page of companies. count.value is the total, and count.isEstimate says whether that total is estimated. An empty items array is still a billed call. - Instructions: Search companies with a filter object. 10 credits per successful call, including an empty page, because the vendor charges 0.25 credits per call and that is floored to one paid unit. dsl.limit is at most 25. - Cost: 2 credits per call - Capability file: [Company search](https://alexandria.firecrawl.dev/agents/providers/aviato/companies/search) Accepted options: - `dsl` (object, required): Search definition: { filters, limit, offset, sort }. filters is a non-empty list of column filters. limit is 1 to 25. offset is 0 to 10000. Example: `{}` Response schema example: ```json { "items": [], "count": {} } ``` ### Company employees - Capability: `companies/employees` - Description: Records in employees. The body also has pages and totalResults for the whole list. An empty page is still billed. The call is accepted only when employees is an array and pages and totalResults are numbers. - Instructions: List employees for one company. 10 credits per successful call, including an empty page; the price is per call, not per row, so pass perPage=25 to read up to 25 rows at once (omitted, a call returns one row). A 404 costs nothing. - Cost: 3 credits per call - Capability file: [Company employees](https://alexandria.firecrawl.dev/agents/providers/aviato/companies/employees) Accepted options: - `id` (string): Aviato company id. Example: `` - `linkedinID` (string): LinkedIn company slug. Example: `` - `linkedinNumID` (string): Numeric LinkedIn company id. Example: `` - `linkedinURL` (string): Company LinkedIn URL. Example: `` - `website` (string): Company domain or URL, such as stripe.com. Example: `` - `perPage` (number): Rows per page, from 1 to 25. Omitted calls request 1. The credit price is per call, not per row. Example: `1` - `page` (number): Page number, starting at 0. Example: `0` Response schema example: ```json { "employees": [ { "personID": "", "companyName": "", "positionList": [] } ] } ``` ### Company founders - Capability: `companies/founders` - Description: Records in founders. The body also has pages and totalResults for the whole list. An empty page is still billed. The call is accepted only when founders is an array and pages and totalResults are numbers. - Instructions: List founders for one company. 10 credits per successful call, including an empty page; the price is per call, not per row, so pass perPage=25 to read up to 25 rows at once (omitted, a call returns one row). A 404 costs nothing. - Cost: 5 credits per call - Capability file: [Company founders](https://alexandria.firecrawl.dev/agents/providers/aviato/companies/founders) Accepted options: - `id` (string): Aviato company id. Example: `` - `linkedinID` (string): LinkedIn company slug. Example: `` - `linkedinNumID` (string): Numeric LinkedIn company id. Example: `` - `linkedinURL` (string): Company LinkedIn URL. Example: `` - `website` (string): Company domain or URL, such as stripe.com. Example: `` - `perPage` (number): Rows per page, from 1 to 25. Omitted calls request 1. The credit price is per call, not per row. Example: `1` - `page` (number): Page number, starting at 0. Example: `0` Response schema example: ```json { "founders": [ { "id": "", "fullName": "", "firstName": "", "lastName": "" } ] } ``` ### Funding rounds - Capability: `companies/funding-rounds` - Description: Every funding round on record for one company, with its date, stage, amount, valuation and investors. Records in fundingRounds. The body also has pages and totalResults for the whole list. An empty page is still billed. The call is accepted only when fundingRounds is an array and pages and totalResults are numbers. - Instructions: A company's full funding round history, from its earliest seed or angel round to its latest growth round, years back and not just recent raises: each round's name and stage, announcement date, amount raised, valuation when known, and its lead and other investors (firms and individual angels). Use it for questions like "what rounds has Stripe raised and who led each", "how much did Figma raise in its Series B", "who invested in Snowflake's Series A", "total raised by Discord" or "which VCs backed Shopify before its IPO". Takes the company's domain (website), LinkedIn URL or Aviato id. 10 credits per successful call, including an empty page; the price is per call, not per row, so pass perPage=25 to read up to 25 rows at once (omitted, a call returns one row). A 404 costs nothing. - Cost: 5 credits per call - Capability file: [Funding rounds](https://alexandria.firecrawl.dev/agents/providers/aviato/companies/funding-rounds) Accepted options: - `id` (string): Aviato company id. Example: `` - `linkedinID` (string): LinkedIn company slug. Example: `` - `linkedinNumID` (string): Numeric LinkedIn company id. Example: `` - `linkedinURL` (string): Company LinkedIn URL. Example: `` - `website` (string): Company domain or URL, such as stripe.com. Example: `` - `perPage` (number): Rows per page, from 1 to 25. Omitted calls request 1. The credit price is per call, not per row. Example: `1` - `page` (number): Page number, starting at 0. Example: `0` Response schema example: ```json { "fundingRounds": [ { "id": 0, "name": "", "stage": "", "announcedOn": "", "moneyRaised": 0, "valuation": 0, "leadCompanyInvestorList": [], "companyInvestorList": [], "leadPersonInvestorList": [], "personInvestorList": [], "companyID": "" } ] } ``` ### Acquisitions - Capability: `companies/acquisitions` - Description: Every acquisition the company made, with its date, price and the acquired company. Records in acquisitions. The body also has pages and totalResults for the whole list. An empty page is still billed. The call is accepted only when acquisitions is an array and pages and totalResults are numbers. - Instructions: The companies one company has acquired, across its history: each acquisition's announcement date, the price paid when disclosed, and the acquired company's profile (what it does, where it is, industry, headcount, website). Use for "what startups has Stripe acquired" or "Salesforce's acquisitions and what it paid". Takes the acquirer's domain (website), LinkedIn URL or Aviato id. 20 credits per successful call, including an empty page; the price is per call, not per row, so pass perPage=25 to read up to 25 rows at once (omitted, a call returns one row). A 404 costs nothing. - Cost: 10 credits per call - Capability file: [Acquisitions](https://alexandria.firecrawl.dev/agents/providers/aviato/companies/acquisitions) Accepted options: - `id` (string): Aviato company id. Example: `` - `linkedinID` (string): LinkedIn company slug. Example: `` - `linkedinNumID` (string): Numeric LinkedIn company id. Example: `` - `linkedinURL` (string): Company LinkedIn URL. Example: `` - `website` (string): Company domain or URL, such as stripe.com. Example: `` - `perPage` (number): Rows per page, from 1 to 25. Omitted calls request 1. The credit price is per call, not per row. Example: `1` - `page` (number): Page number, starting at 0. Example: `0` Response schema example: ```json { "acquisitions": [ { "id": 0, "announcedOn": "", "acquirerName": "", "acquireeName": "", "price": 0, "acquireeCompany": {} } ] } ``` ### Investments received - Capability: `companies/investments` - Description: One row per investor and investment into the company. Records in investments. The body also has pages and totalResults for the whole list. An empty page is still billed. The call is accepted only when investments is an array and pages and totalResults are numbers. - Instructions: Every investor that has put money into one company, firm by firm and angel by angel, across all its rounds and years: the investor (a venture firm, corporate or individual, with its profile), the investment date and the round amount. Use for "who are Plaid's investors" or "list every investor in Airbnb"; for round-by-round detail (stage, amount, leads) use companies/funding-rounds. Takes the company's domain (website), LinkedIn URL or Aviato id. 10 credits per successful call, including an empty page; the price is per call, not per row, so pass perPage=25 to read up to 25 rows at once (omitted, a call returns one row). A 404 costs nothing. - Cost: 5 credits per call - Capability file: [Investments received](https://alexandria.firecrawl.dev/agents/providers/aviato/companies/investments) Accepted options: - `id` (string): Aviato company id. Example: `` - `linkedinID` (string): LinkedIn company slug. Example: `` - `linkedinNumID` (string): Numeric LinkedIn company id. Example: `` - `linkedinURL` (string): Company LinkedIn URL. Example: `` - `website` (string): Company domain or URL, such as stripe.com. Example: `` - `perPage` (number): Rows per page, from 1 to 25. Omitted calls request 1. The credit price is per call, not per row. Example: `1` - `page` (number): Page number, starting at 0. Example: `0` Response schema example: ```json { "investments": [ { "id": 0, "date": "", "totalAmountRaised": 0, "companyInvestor": {}, "person": {}, "companyInvestorID": "", "personID": "", "companyID": "" } ] } ``` ### Investments made - Capability: `companies/investments-outbound` - Description: One row per portfolio company investment the investor made. Records in investments. The body also has pages and totalResults for the whole list. An empty page is still billed. The call is accepted only when investments is an array and pages and totalResults are numbers. - Instructions: An investor's portfolio: every company a venture firm, fund, corporate venture arm or other company has invested in, across its history, each with the investment date, the round amount and the portfolio company's profile (what it does, location, industry, headcount, website). Use for "what companies has Andreessen Horowitz invested in", "Sequoia's portfolio companies" or "what has Salesforce Ventures backed". Takes the investor's own domain (website, for example a16z.com), LinkedIn URL or Aviato id. 10 credits per successful call, including an empty page; the price is per call, not per row, so pass perPage=25 to read up to 25 rows at once (omitted, a call returns one row). A 404 costs nothing. - Cost: 5 credits per call - Capability file: [Investments made](https://alexandria.firecrawl.dev/agents/providers/aviato/companies/investments-outbound) Accepted options: - `id` (string): Aviato company id. Example: `` - `linkedinID` (string): LinkedIn company slug. Example: `` - `linkedinNumID` (string): Numeric LinkedIn company id. Example: `` - `linkedinURL` (string): Company LinkedIn URL. Example: `` - `website` (string): Company domain or URL, such as stripe.com. Example: `` - `perPage` (number): Rows per page, from 1 to 25. Omitted calls request 1. The credit price is per call, not per row. Example: `1` - `page` (number): Page number, starting at 0. Example: `0` Response schema example: ```json { "investments": [ { "id": 0, "date": "", "totalAmountRaised": 0, "company": {}, "companyID": "", "companyInvestorID": "" } ] } ``` ### Person enrichment - Capability: `people/enrich` - Description: One person. Preview is the short record. A paid record adds headline, location, skills, and experience. - Instructions: Enrich a person from a profile URL, an Aviato id, or an email. preview=true is free. A profile enrich costs 50 credits. Sending email costs 80, including when a profile URL is sent too. A 404 costs nothing. - Cost: 25 credits per person enrich - Capability file: [Person enrichment](https://alexandria.firecrawl.dev/agents/providers/aviato/people/enrich) Accepted options: - `id` (string): Aviato person id. Example: `` - `linkedinID` (string): LinkedIn profile slug. Example: `` - `linkedinEntityId` (string): LinkedIn entity id. Example: `` - `linkedinURL` (string): Public profile URL. Example: `` - `email` (string): Work or personal email. Example: `` - `preview` (boolean): Return id, name, and URLs without a charge. Example: `false` - `full` (boolean): Include investments and founded companies on the paid record. Example: `false` - `require` (string[]): Fields that must be present. A miss on one of them is a free 404. Example: `[]` Response schema example: ```json { "id": "", "fullName": "", "firstName": "", "lastName": "", "headline": "", "location": "", "about": "", "URLs": {}, "skills": [] } ``` ### People search - Capability: `people/search` - Description: items is the page of people. count.value is the total. An empty items array is still a billed call. - Instructions: Search people with a filter object. 10 credits per successful call, including an empty page. Use people/enrich or people/email-find on an id from items. dsl.limit is at most 25. - Cost: 2 credits per call - Capability file: [People search](https://alexandria.firecrawl.dev/agents/providers/aviato/people/search) Accepted options: - `dsl` (object, required): Search definition: { filters, limit, offset, sort }. filters is a non-empty list of column filters. limit is 1 to 25. offset is 0 to 10000. Example: `{}` Response schema example: ```json { "items": [], "count": {} } ``` ### Email finder - Capability: `people/email-find` - Description: emails is the list. An empty list costs nothing. - Instructions: Find email addresses for one person from a profile URL, an id, or another email. Set type to personal, work, or student. 80 credits when at least one address comes back. An empty list costs nothing. - Cost: 35 credits per record - Capability file: [Email finder](https://alexandria.firecrawl.dev/agents/providers/aviato/people/email-find) Accepted options: - `type` (string): Limit the addresses to personal, work, or student. Omit it for every type. Example: `personal` - `id` (string): Aviato person id. Example: `` - `linkedinID` (string): LinkedIn profile slug. Example: `` - `linkedinEntityId` (string): LinkedIn entity id. Example: `` - `linkedinURL` (string): Public profile URL. Example: `` - `email` (string): Work or personal email. Example: `` Response schema example: ```json { "emails": [] } ```