--- title: "Enrich by properties" method: POST path: "/companies/enrich" tags: ["Company / Enrichment"] --- # Enrich by properties `POST /companies/enrich` ## Request - Base URL: `https://api.companyenrich.com` - URL: `https://api.companyenrich.com/companies/enrich` - Auth: API key in header `Authorization` **Cost:** 1 credit per call Enriches a company using its properties. You need to provide at least one of the following properties: - Name - LinkedinUrl - LinkedinId - TwitterUrl - FacebookUrl - InstagramUrl Best match is used to determine the company in case of ambiguity. ## Query parameters - `expand` string[] ## Request body - EnrichRequest - `name` string, nullable: The name of the company to enrich - `linkedinUrl` string, uri, nullable: The LinkedIn URL of the company to enrich - `linkedinId` string, nullable: The LinkedIn ID of the company to enrich - `twitterUrl` string, uri, nullable: The Twitter URL of the company to enrich - `facebookUrl` string, uri, nullable: The Facebook URL of the company to enrich - `instagramUrl` string, uri, nullable: The Instagram URL of the company to enrich - `youTubeUrl` string, uri, nullable: The YouTube URL of the company to enrich ## Response `200` OK - CompanyInfo - `id` string, uuid, required: The unique identifier of the company - `name` string, nullable: The name of the company - `domain` string, nullable: The primary domain name of the company - `website` string, uri, nullable: The website URL of the company - `type` unknown - `legalName` string, nullable: The legal name of the company - `industry` string, nullable: The main industry of the company - `industries` string[], nullable: The industries associated with the company - `categories` CompanyCategory[], nullable: The categories of the company from most to least specific. - `employees` unknown - `reported_employees` unknown - `revenue` unknown - `description` string, nullable: The description of the company - `keywords` string[], nullable: The search keywords of the company - `technologies` string[], nullable: The technologies associated with the company - `subsidiaries` string[], nullable: The subsidiaries associated with the company - `founded_year` integer, nullable: The year the company was founded - `naics_codes` string[], nullable: The NAICS codes associated with the company - `location` CompanyLocationInfo, nullable: The location information of the company - `country` CountryInfo, nullable: The origin country information of the company - `code` string: The ISO 3166-1 alpha-2 code of the country - `name` string: The name of the country - `latitude` number, float, nullable: The latitude of the country - `longitude` number, float, nullable: The longitude of the country - `state` StateInfo, nullable: The state information of the company - `id` integer: The ID of the state - `name` string: The name of the state - `code` string, nullable: The ISO 3166-2 code of the state - `latitude` number, float, nullable: The latitude of the state - `longitude` number, float, nullable: The longitude of the state - `city` CityInfo, nullable: The city information of the company - `id` integer: The ID of the city - `name` string: The name of the city - `latitude` number, float, nullable: The latitude of the city - `longitude` number, float, nullable: The longitude of the city - `address` string, nullable - `postal_code` string, nullable - `phone` string, nullable - `financial` CompanyFinancialInfo, nullable: The financial information of the company - `stock_symbol` string, nullable - `stock_exchange` string, nullable - `total_funding` integer, nullable - `funding_stage` string, nullable - `funding_date` string, date-time, nullable - `funding` CompanyFundingInfo[], nullable - `date` string, date-time, nullable - `amount` string, nullable - `type` string, nullable - `url` string, nullable - `from` string, nullable - `socials` CompanySocialUrls: The social URLs of the company - `linkedin_url` string, uri, nullable: The LinkedIn URL of the company - `linkedin_id` string, nullable: The LinkedIn ID of the company - `twitter_url` string, uri, nullable: The Twitter URL of the company - `facebook_url` string, uri, nullable: The Facebook URL of the company - `instagram_url` string, uri, nullable: The Instagram URL of the company - `angellist_url` string, uri, nullable: The AngelList URL of the company - `crunchbase_url` string, uri, nullable: The Crunchbase URL of the company - `youtube_url` string, uri, nullable: The YouTube URL of the company - `github_url` string, uri, nullable: The GitHub URL of the company - `g2_url` string, uri, nullable: The G2 URL of the company - `page_rank` number, float, nullable: The page rank of the company - `workforce` CompanyWorkforceInfo, nullable: Expanded workforce insights for the company. This field is only returned when `expand=workforce` is requested. - `company_id` string, uuid, required: The CompanyEnrich ID of the company. - `domain` string, required: The canonical domain of the company. - `observed_employee_count` integer: Observed number of distinct current employees in our people dataset. - `employee_count_range` unknown - `department_headcount` CompanyWorkforceDepartmentHeadcount, required: Headcount grouped by root department name. - `c_suite` integer, nullable: Headcount in the c-suite root department. - `product_management` integer, nullable: Headcount in the product management root department. - `engineering_technical` integer, nullable: Headcount in the engineering and technical root department. - `design` integer, nullable: Headcount in the design root department. - `education` integer, nullable: Headcount in the education root department. - `finance` integer, nullable: Headcount in the finance root department. - `human_resources` integer, nullable: Headcount in the human resources root department. - `information_technology` integer, nullable: Headcount in the information technology root department. - `legal` integer, nullable: Headcount in the legal root department. - `marketing` integer, nullable: Headcount in the marketing root department. - `medical_health` integer, nullable: Headcount in the medical and health root department. - `operations` integer, nullable: Headcount in the operations root department. - `sales` integer, nullable: Headcount in the sales root department. - `consulting` integer, nullable: Headcount in the consulting root department. - `unclassified_headcount` integer: Headcount where department could not be classified. - `history` CompanyWorkforceHistoryEntry[], nullable: Monthly workforce snapshots showing headcount changes over time. Only months where headcount changed are included. - `date` string, date, required: First day of the month for this snapshot. - `observed_employee_count` integer: Observed number of distinct employees in our people dataset for this month. - `employee_count_range` unknown - `department_headcount` CompanyWorkforceDepartmentHeadcount, required: Headcount grouped by root department name. - `c_suite` integer, nullable: Headcount in the c-suite root department. - `product_management` integer, nullable: Headcount in the product management root department. - `engineering_technical` integer, nullable: Headcount in the engineering and technical root department. - `design` integer, nullable: Headcount in the design root department. - `education` integer, nullable: Headcount in the education root department. - `finance` integer, nullable: Headcount in the finance root department. - `human_resources` integer, nullable: Headcount in the human resources root department. - `information_technology` integer, nullable: Headcount in the information technology root department. - `legal` integer, nullable: Headcount in the legal root department. - `marketing` integer, nullable: Headcount in the marketing root department. - `medical_health` integer, nullable: Headcount in the medical and health root department. - `operations` integer, nullable: Headcount in the operations root department. - `sales` integer, nullable: Headcount in the sales root department. - `consulting` integer, nullable: Headcount in the consulting root department. - `unclassified_headcount` integer: Headcount where department could not be classified. - `logo_url` string, nullable: The logo URL of the company - `seo_description` string, nullable: The SEO description of the company - `updated_at` string, date-time: The last updated timestamp of the company ## Other responses - `400`: Bad Request - `401`: Unauthorized - `402`: Payment Required - `404`: Not Found - `422`: Unprocessable Entity - `429`: Too Many Requests --- [API](https://skmtc.dev/companyenrich/apis/company-enrich-api.md) - [All operations](https://skmtc.dev/companyenrich/apis/company-enrich-api/llms.txt) - [OpenAPI document](https://skmtc.dev/companyenrich/apis/company-enrich-api/revisions/07f84debab87?raw)