MixRank

MixRank Companies API

The Companies API from MixRank — 9 operation(s) for companies.

GitHub OpenAPI

Documentation

📖
Documentation
https://mixrank.com/api/documentation
📖
APIReference
https://mixrank.com/api/documentation
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/mixrank/refs/heads/main/authentication/mixrank-authentication.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/mixrank/refs/heads/main/openapi/mixrank-companies-api-openapi.yml

Other Resources

🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/mixrank/refs/heads/main/conventions/mixrank-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/mixrank/refs/heads/main/errors/mixrank-problem-types.yml
🔗
Lifecycle
https://raw.githubusercontent.com/api-evangelist/mixrank/refs/heads/main/lifecycle/mixrank-lifecycle.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/mixrank/refs/heads/main/data-model/mixrank-data-model.yml
🔗
AgenticAccess
https://raw.githubusercontent.com/api-evangelist/mixrank/refs/heads/main/agentic-access/mixrank-agentic-access.yml

OpenAPI Specification

mixrank-companies-api-openapi.yml Raw ↑ 
openapi: 3.1.0
info:
  title: MixRank Data Account Companies API
  version: '2'
  description: MixRank's REST Data API exposes the company (Enrich/Match), people, email verification, mobile app & SDK intelligence (iOS App Store and Google Play Store), app rankings, in-app purchases, app privacy labels, and web technographic datasets. Responses are JSON; the API key is passed as a path segment. This specification was generated by the API Evangelist enrichment pipeline from MixRank's published API documentation and is not an official MixRank artifact.
  contact:
    name: MixRank
    url: https://mixrank.com/api/documentation
  x-generated-by: api-evangelist-enrichment
  x-source: https://mixrank.com/api/documentation
servers:
- url: https://api.mixrank.com/v2/json/{api_key}
  description: Production. The API key is supplied as a path segment.
  variables:
    api_key:
      default: YOUR_API_KEY
      description: Your MixRank API key
tags:
- name: Companies
paths:
  /companies:
    get:
      operationId: listCompanies
      summary: List/search the company directory
      tags:
      - Companies
      responses:
        '200':
          description: Successful JSON response
          content:
            application/json:
              schema:
                type: object
        '400':
          $ref: '#/components/responses/Error'
        '401':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '429':
          $ref: '#/components/responses/Error'
      parameters:
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/PageSize'
      - $ref: '#/components/parameters/SortField'
      - $ref: '#/components/parameters/SortOrder'
  /companies/{company_id}:
    get:
      operationId: getCompany
      summary: Get a company overview by id
      tags:
      - Companies
      responses:
        '200':
          description: Successful JSON response
          content:
            application/json:
              schema:
                type: object
        '400':
          $ref: '#/components/responses/Error'
        '401':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '429':
          $ref: '#/components/responses/Error'
      parameters:
      - name: company_id
        in: path
        required: true
        schema:
          type: string
        description: company_id identifier
  /companies/match:
    get:
      operationId: matchCompany
      summary: Fuzzy match a company by name, URL, or LinkedIn
      tags:
      - Companies
      responses:
        '200':
          description: Successful JSON response
          content:
            application/json:
              schema:
                type: object
        '400':
          $ref: '#/components/responses/Error'
        '401':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '429':
          $ref: '#/components/responses/Error'
  /companies/{company_id}/employee-metrics:
    get:
      operationId: getCompanyEmployeeMetrics
      summary: Headcount by employee type for a company
      tags:
      - Companies
      responses:
        '200':
          description: Successful JSON response
          content:
            application/json:
              schema:
                type: object
        '400':
          $ref: '#/components/responses/Error'
        '401':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '429':
          $ref: '#/components/responses/Error'
      parameters:
      - name: company_id
        in: path
        required: true
        schema:
          type: string
        description: company_id identifier
  /companies/{company_id}/employee-metrics/{job_tag_id}/timeseries:
    get:
      operationId: getCompanyEmployeeMetricsTimeseries
      summary: Employee-metric trends for a job tag over time
      tags:
      - Companies
      responses:
        '200':
          description: Successful JSON response
          content:
            application/json:
              schema:
                type: object
        '400':
          $ref: '#/components/responses/Error'
        '401':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '429':
          $ref: '#/components/responses/Error'
      parameters:
      - name: company_id
        in: path
        required: true
        schema:
          type: string
        description: company_id identifier
      - name: job_tag_id
        in: path
        required: true
        schema:
          type: string
        description: job_tag_id identifier
  /companies/{company_id}/timeseries:
    get:
      operationId: getCompanyTimeseries
      summary: Employee and social trends for a company over time
      tags:
      - Companies
      responses:
        '200':
          description: Successful JSON response
          content:
            application/json:
              schema:
                type: object
        '400':
          $ref: '#/components/responses/Error'
        '401':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '429':
          $ref: '#/components/responses/Error'
      parameters:
      - name: company_id
        in: path
        required: true
        schema:
          type: string
        description: company_id identifier
  /jobtags:
    get:
      operationId: listJobTags
      summary: List the job classification ontology
      tags:
      - Companies
      responses:
        '200':
          description: Successful JSON response
          content:
            application/json:
              schema:
                type: object
        '400':
          $ref: '#/components/responses/Error'
        '401':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '429':
          $ref: '#/components/responses/Error'
      parameters:
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/PageSize'
      - $ref: '#/components/parameters/SortField'
      - $ref: '#/components/parameters/SortOrder'
  /companies/segment-preview:
    get:
      operationId: previewCompanySegment
      summary: Preview a company segment query with instant results
      tags:
      - Companies
      responses:
        '200':
          description: Successful JSON response
          content:
            application/json:
              schema:
                type: object
        '400':
          $ref: '#/components/responses/Error'
        '401':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '429':
          $ref: '#/components/responses/Error'
    post:
      operationId: previewCompanySegmentPost
      summary: Preview a company segment query (POST body)
      tags:
      - Companies
      responses:
        '200':
          description: Successful JSON response
          content:
            application/json:
              schema:
                type: object
        '400':
          $ref: '#/components/responses/Error'
        '401':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '429':
          $ref: '#/components/responses/Error'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: Segment query definition
  /companies/segment-query:
    get:
      operationId: queryCompanySegment
      summary: Run a company segment query producing a downloadable file
      tags:
      - Companies
      responses:
        '200':
          description: Successful JSON response
          content:
            application/json:
              schema:
                type: object
        '400':
          $ref: '#/components/responses/Error'
        '401':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '429':
          $ref: '#/components/responses/Error'
    post:
      operationId: queryCompanySegmentPost
      summary: Run a company segment query (POST body)
      tags:
      - Companies
      responses:
        '200':
          description: Successful JSON response
          content:
            application/json:
              schema:
                type: object
        '400':
          $ref: '#/components/responses/Error'
        '401':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '429':
          $ref: '#/components/responses/Error'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: Segment query definition
components:
  parameters:
    SortOrder:
      name: sort_order
      in: query
      required: false
      schema:
        type: string
        enum:
        - asc
        - desc
      description: Sort direction
    PageSize:
      name: page_size
      in: query
      required: false
      schema:
        type: integer
      description: Results per page (varies by endpoint, typically 1-100)
    SortField:
      name: sort_field
      in: query
      required: false
      schema:
        type: string
      description: Field to sort by
    Offset:
      name: offset
      in: query
      required: false
      schema:
        type: integer
        default: 0
      description: Number of results to skip
  schemas:
    Error:
      type: object
      properties:
        errors:
          type: array
          items:
            type: string
          description: List of error messages
  responses:
    Error:
      description: Error response with an errors array and an appropriate HTTP status code
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
externalDocs:
  description: MixRank API documentation
  url: https://mixrank.com/api/documentation