--- title: "Match" method: GET path: "/companies/match" tags: ["Companies"] --- # Match `GET /companies/match` ## Request - Base URL: `https://api.mixrank.com/v2/json/YOUR_API_KEY` - URL: `https://api.mixrank.com/v2/json/YOUR_API_KEY/companies/match` - Auth: none declared Find at most one matching company. At least one of name, url, linkedin or linkedin_company_id is required; without one the request returns 404. Matching uses linkedin_company_id first, then a usable LinkedIn company URL, then website or name candidates ranked to choose a single result. Website URLs normalize to root domains. Financial content is disabled by default. With enable=company_financials, one credit is billed when a financial object is available. company_financials is null when unavailable, {} when available but disabled, and an object containing funding when enabled. Required permissions for your API key's user: `corp.companies`. ## Query parameters - `name` string - `url` string - `linkedin` string - `linkedin_company_id` integer - `enable` string ## Response `200` Successful response. - union - object - `total` integer, nullable - `offset` unknown - `page_size` unknown - `results` object[] - `id` integer, nullable: Company ID. - `name` string, nullable: Company name. - `slug` string, nullable: A unique textual identifier for this company. - `rank` integer, nullable: MixRank Rank (lower numbers are better and indicate more significant companies). - `score` number, nullable: MixRank Authority Score™. - `employees` integer, nullable: Number of current employees at this company. - `rank_internetretailer` integer, nullable: Internet Retailer Rank. - `rank_incmagazine` integer, nullable: Inc. 5000 Rank. - `rank_fortune` integer, nullable: Fortune Rank. - `address` object, nullable: Primary address for this company. - `street_address` string, nullable: Street address of this company. - `city` string, nullable: City of this company. - `region` string, nullable: State/Province of the company headquarters. - `country` string, nullable: Headquarters country of this company. - `postal_code` string, nullable: Postal routing code of this company. - `linkedin` object, nullable: LinkedIn company profile. - `id` integer, nullable: LinkedIn company ID. - `website` string, nullable: LinkedIn company website. - `url` string, nullable: LinkedIn company URL. - `type` string, nullable: Description of the company type (e.g. "Public Company", "Privately Held"). - `size` string, nullable: Description of the company size in terms of employees (e.g. "1-10 employees", "10,001+ employees"). - `name` string, nullable: Name. - `founded` integer, nullable: Foundation year. - `description` string, nullable: Description. - `locations` object[], nullable: Locations. - `address` string, nullable: Location address. - `is_primary` boolean, nullable: Boolean flag to distinguish between the primary location and the rest, "true" when is considered a primary address, otherwise "false". - `country` string, nullable: Two letters country code (ISO 3166-1 alpha-2). - `specialties` string[], nullable: Company specialties (e.g. "AI", "Cloud Computing"). - `employee_count` integer, nullable: Employee count. - `follower_count` integer, nullable: Followers on LinkedIn. - `logo_url` string, nullable: Company logo download URL. - `similar_pages` integer[], nullable: List of linkedin_company ids found in "Similar pages" section. - `web` object, nullable: Fields related to web platform. - `site_count` integer, nullable: Number of websites published by this company. - `tag_count` integer, nullable: Number of Web Tags produced by this company. - `appstore` object, nullable: Fields related to Apple App Store. - `app_count` integer, nullable: Number of iOS apps published by this company. - `sdk_count` integer, nullable: Number of iOS SDKs produced by this company. - `playstore` object, nullable: Fields related to Google Play Store. - `app_count` integer, nullable: Number of Android apps published by this company. - `sdk_count` integer, nullable: Number of Android SDKs produced by this company. - `industries` object[], nullable: Company industries. - `id` integer, nullable: Industry ID - `name` string, nullable: Industry name - `is_primary` boolean, nullable: Whether or not this is a primary industry that this company is involved in - `sic` object[], nullable: Standard Industry Classification codes for this company. - `id` string, nullable: Industry ID. - `name` string, nullable: Industry name. - `naics` object[], nullable: North American Industry Classification System codes for this company. - `id` string, nullable: Industry ID - `name` string, nullable: Industry name. - `company_financials` object, nullable: Funding and financial data for this company (paid add-on; enable with enable=company_financials). null when no data exists; {} when data exists but the add-on is not enabled; {"funding": {...}} when enabled. Billed one credit per object when enabled and data is present. - `funding` object, nullable: Merged, vendor-neutral funding summary for the company. - `total_funding` integer, nullable: Total capital raised across all rounds (assumed USD). - `total_funding_currency` string, nullable: Currency of total_funding (e.g. "USD"); null when total_funding is null. - `round_count` integer, nullable: Number of funding rounds in this object. - `rounds` object[], nullable: Funding rounds, newest first (undated rounds last). - `round_type` string, nullable: Round name/type (e.g. "Series A", "Debt financing"). - `announced_date` string, nullable: Date the round was announced (ISO 8601), or null. - `amount` integer, nullable: Amount raised in the round, or null. - `currency` string, nullable: Currency of amount, or null. - `deal_status` string, nullable: Round deal status (e.g. "announced"). - `lead_investor` string, nullable: Lead investor name, or null. - `investors` string[], nullable: Names of investors participating in the round. - object - `errors` object, required ## Other responses - `400`: Invalid request parameters or unsupported enable value. - `403`: Invalid key or insufficient endpoint permissions. - `404`: No matching company or no usable match input. - `408`: Lookup timed out. - `429`: Concurrent request limit exceeded. - `500`: Internal API error. --- [API](https://skmtc.dev/mixrank/apis/mixrank-api.md) - [All operations](https://skmtc.dev/mixrank/apis/mixrank-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mixrank/apis/mixrank-api/revisions/786d3fcfe918?raw)