Retrieve an enriched company profile from a domain, company name, LinkedIn URL, or RocketReach company id. Returns firmographics including headcount, industry, founded year, location, revenue band, technology stack, and key social and contact metadata.
openapi: 3.1.0
info:
title: RocketReach Company Lookup API
version: 1.0.0
description: Look up a single company's enriched firmographic profile from domain, name, or LinkedIn URL.
contact:
name: RocketReach Support
email: api@rocketreach.co
license:
name: Proprietary
termsOfService: https://rocketreach.co/legal/terms-of-use
servers:
- url: https://api.rocketreach.co/api/v2
description: RocketReach v2 API
- url: https://api.rocketreach.co/v1/api
description: RocketReach v1 API
security:
- RocketReachAPIKey: []
paths:
/company/lookup/:
get:
operationId: create_company_lookup
description: Search Companies by Criteria
summary: Company Lookup API
parameters:
- in: query
name: domain
schema:
type: string
minLength: 1
description: Domain of the desired company to lookup (preferred).
- in: query
name: id
schema:
type: integer
description: RocketReach internal unique company ID
- in: query
name: linkedin_url
schema:
type: string
pattern: ''
minLength: 1
description: LinkedIn URL of the desired company to lookup.
- in: query
name: name
schema:
type: string
minLength: 1
description: Name of the desired company to lookup.
- in: query
name: ticker
schema:
type: string
minLength: 1
description: Stock ticker of the desired company to lookup.
tags:
- Company Data API
security:
- RocketReachAPIKey: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CompiledCompanyAPISerializerWithExtendedCompanyAttributes'
description: Success. Returns the profile data for the company lookup.
'400':
description: Bad Request. The request is malformed or missing required parameters.
'401':
description: Unauthorized. API Key is missing or invalid.
'403':
description: Forbidden. API Key lacks permission to perform this action.
'404':
description: Not Found. The requested resource (e.g., profile) does not exist.
'429':
description: Too Many Requests. API request limit reached -- slow down requests.
'500':
description: Internal Server Error. Unexpected error on RocketReach servers. Try again later.
/universal/company/lookup:
get:
operationId: create_universal_company_lookup
description: Search Companies by Criteria
summary: ⭐ Universal Company Lookup API
parameters:
- in: query
name: domain
schema:
type: string
minLength: 1
description: Domain of the desired company to lookup (preferred).
- in: query
name: id
schema:
type: integer
description: RocketReach internal unique company ID
- in: query
name: linkedin_url
schema:
type: string
pattern: ''
minLength: 1
description: LinkedIn URL of the desired company to lookup.
- in: query
name: name
schema:
type: string
minLength: 1
description: Name of the desired company to lookup.
- in: query
name: ticker
schema:
type: string
minLength: 1
description: Stock ticker of the desired company to lookup.
tags:
- Company Data API
security:
- RocketReachAPIKey: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CompiledCompanyAPISerializerWithExtendedCompanyAttributes'
description: Success. Returns the profile data for the company lookup.
'400':
description: Bad Request. The request is malformed or missing required parameters.
'401':
description: Unauthorized. API Key is missing or invalid.
'403':
description: Forbidden. API Key lacks permission to perform this action.
'404':
description: Not Found. The requested resource (e.g., profile) does not exist.
'429':
description: Too Many Requests. API request limit reached -- slow down requests.
'500':
description: Internal Server Error. Unexpected error on RocketReach servers. Try again later.
components:
securitySchemes:
RocketReachAPIKey:
type: apiKey
name: Api-Key
in: header
description: RocketReach account API key. You can locate your API Key from the "My API Key" section of the [API account
page](https://rocketreach.co/account?section=nav_gen_api). Requests to the API are authenticated using the Api-Key
request header. Older clients may use an `api_key` query parameter, but this behavior is deprecated.
schemas:
CompanyQuarterlyGrowth:
type: object
properties:
year:
type: integer
quarter:
type: integer
values:
type: array
items:
type: integer
minLength: 3
maxLength: 3
readOnly: true
CompiledCompanyAPISerializerWithExtendedCompanyAttributes:
type: object
description: Serializes purchased company fields when looked up.
properties:
id:
type: integer
description: RocketReach internal unique company ID
example: 123456
name:
type: string
description: Name of the company
domain:
type: string
description: Web domain for the company
email_domain:
type: string
description: Email domain for the company
website_domain:
type:
- string
- 'null'
readOnly: true
description: Website for the company
ticker_symbol:
type:
- string
- 'null'
description: Ticker symbol for the company (if available)
links:
type:
- object
- 'null'
properties:
facebook:
type: string
twitter:
type: string
linkedin:
type: string
readOnly: true
description: Social media links for the company
year_founded:
type:
- integer
- 'null'
readOnly: true
description: Year the company was founded
address:
$ref: '#/components/schemas/CompiledCompanyAddress'
description: Street address of the company
phone:
type:
- string
- 'null'
description: Phone number for the company
fax:
type:
- string
- 'null'
description: Fax number for the company
num_employees:
type:
- integer
- 'null'
description: Number of employees working at the company
revenue:
type:
- integer
- 'null'
description: Revenue of the company
funding_investors:
type: array
items:
type: string
description: List of names of founding investors for the company
industry:
type:
- string
- 'null'
readOnly: true
description: Industry of the company
sic_codes:
type: array
items:
type: integer
description: List of SIC codes for the company. Standard Industrial Classification (SIC) codes, are four-digit numerical
codes used to categorize businesses by their primary industry
rr_profile_url:
type: string
readOnly: true
description: URL of the RocketReach company profile page for the company
description:
type:
- string
- 'null'
description: Description of the company
industry_keywords:
type: array
items:
type: string
readOnly: true
description: List of industry keywords for the company
naics_codes:
type: array
items:
type: integer
description: List of NAICS codes for the company. North American Industry Classification System (NAICS) codes are
used to classify businesses by their primary industry
techstack:
type: array
items:
type: string
description: List of technologies used by the company
industries:
type: array
items:
type: string
description: List of industries the company operates in
competitors:
type:
- array
- 'null'
items:
type: string
readOnly: true
description: List of competitors for the company
departments:
type: object
additionalProperties:
type: integer
readOnly: true
description: List of departments within the company
company_growth:
type: array
items:
$ref: '#/components/schemas/CompanyQuarterlyGrowth'
readOnly: true
description: Growth rate of the company
CompiledCompanyAddress:
type: object
properties:
description:
type: string
readOnly: true
description: Description of the company location
street:
type: string
readOnly: true
description: Street of the company address
city:
type: string
readOnly: true
description: City of the company address
region:
type: string
readOnly: true
description: Region of the company address
region_code:
type: string
readOnly: true
description: Region code of the company address
postal_code:
type: string
readOnly: true
description: Postal code of the company address
country:
type: string
readOnly: true
description: Country of the company address
country_code:
type: string
readOnly: true
description: Country code of the company address
tags: []