---
title: "Trends"
method: GET
path: "/companies/{company_id}/timeseries"
tags: ["Companies"]
---

# Trends

`GET /companies/{company_id}/timeseries`

## Request

- Base URL: `https://api.mixrank.com/v2/json/YOUR_API_KEY`
- URL: `https://api.mixrank.com/v2/json/YOUR_API_KEY/companies/{company_id}/timeseries`
- Auth: none declared

Employee and followers trends about a company.

Newest samples first; dates are not guaranteed daily. Individual series values can be null. employee_count is the employee count reported by LinkedIn.

Required permissions for your API key's user: `corp.companies`.

## Path parameters

- `company_id` integer, required

## Query parameters

- `offset` integer
- `page_size` integer
- `since` string, date

## Response `200`

Successful response.

- union
  - object
    - `total` integer, nullable
    - `offset` integer, nullable
    - `page_size` integer, nullable
    - `results` object[]
      - `date` string, date, nullable: The date this sample was taken.
      - `employee_count` integer, nullable: Number of employees (headcount).
      - `linkedin_follower_count` integer, nullable: Number of LinkedIn followers.
      - `facebook_like_count` integer, nullable: Number of Facebook likes.
      - `twitter_follower_count` integer, nullable: Number of Twitter followers.
      - `seomoz_link_count` integer, nullable: Number of Seomoz links.
  - object
    - `errors` object, required

## Other responses

- `400`: Missing or invalid required parameter.
- `403`: Invalid key or insufficient endpoint permissions.
- `404`: No matching data.
- `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)