---
title: "Start count estimation for company followers"
method: POST
path: "/lists/{listID}/company-followers/count-estimate"
tags: ["lists"]
---

# Start count estimation for company followers

`POST /lists/{listID}/company-followers/count-estimate`

## Request

- Base URL: `https://api.leadsforge.ai`
- URL: `https://api.leadsforge.ai/lists/{listID}/company-followers/count-estimate`
- Auth: API key in header `Authorization`

Start an async count estimation for company followers with filters

## Path parameters

- `listID` string, required

## Request body

- CountEstimationRequest
  - `companyUrl` string, required
  - `countries` string[]
  - `departments` string[]
  - `jobTitles` string[]
  - `levels` string[]
  - `metros` string[]
  - `states` string[]

## Response `202`

Count estimation started

- CountEstimationResponse
  - `error` string
  - `filtersApplied` CountEstimationFilters
    - `countries` string[]
    - `departments` string[]
    - `jobTitles` string[]
    - `levels` string[]
    - `states` string[]
  - `functionBreakdown` FunctionBreakdownItem[]
    - `count` integer
    - `functionId` string
    - `functionName` string
    - `percentage` number
    - `seniorityBreakdown` SeniorityBreakdownItem[]
      - `count` integer
      - `percentage` number
      - `seniorityId` string
      - `seniorityLevel` string
  - `seniorityBreakdown` SeniorityBreakdownItem[]
    - `count` integer
    - `percentage` number
    - `seniorityId` string
    - `seniorityLevel` string
  - `status` string
  - `totalCount` integer

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/leadsforge/apis/leadsforge-api.md) - [All operations](https://skmtc.dev/leadsforge/apis/leadsforge-api/llms.txt) - [OpenAPI document](https://skmtc.dev/leadsforge/apis/leadsforge-api/revisions/b4a6596215b5?raw)