RocketReach Company Lookup API

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.

RocketReach Company Lookup API is one of 5 APIs that RocketReach publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Company Data, Firmographics, and Enrichment. The published artifact set on APIs.io includes API documentation and an OpenAPI specification.

OpenAPI Specification

rocketreach-company-lookup-api-openapi.yml Raw ↑
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: [email protected]
  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: []