---
title: "POST /v2/companies/analytics/export"
method: POST
path: "/v2/companies/analytics/export"
tags: ["companies", "analytics"]
---

# POST /v2/companies/analytics/export

`POST /v2/companies/analytics/export`

## Request

- Base URL: `https://api.thecompaniesapi.com`
- URL: `https://api.thecompaniesapi.com/v2/companies/analytics/export`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/thecompaniesapi/apis/the-companies-api/docs/v2/companies/analytics/export/post.ts> (a function with typed inputs; its response is checked against the schema)

Export analytics data for search segmentations and lists.

## Request body

- object
  - `actionId` number
  - `attributes` string[]
  - `format` 'csv' | 'json' | 'txt' | 'xls' | 'xml'
  - `full` boolean
  - `listId` number
  - `query` SegmentationCondition[]
    - `attribute` 'about.businessType' | 'about.industries' | 'about.industry' | 'about.name' | 'about.totalEmployees' | 'about.yearFounded' | 'ai.search' | 'analytics.monthlyVisitors' | 'apps' | 'codes.naics' | 'codes.sic' | 'contacts' | 'domain.domain' | 'domain.tld' | 'finances.revenue' | 'finances.stockExchange' | 'locations.headquarters.city.code' | 'locations.headquarters.continent.code' | 'locations.headquarters.country.code' | 'locations.headquarters.county.code' | 'locations.headquarters.state.code' | 'meta.listIds' | 'meta.score' | 'meta.syncedAt' | 'socials' | 'socials.linkedin.id' | 'technologies.active' | 'technologies.categories' | 'urls', required
    - `blockedOperator` boolean
    - `operator` 'and' | 'or', required
    - `sign` 'equals' | 'exactEquals' | 'greater' | 'lower' | 'notEquals', required
    - `values` union[], required
      - union
        - string
        - number
  - `size` number
  - `sort` 'asc' | 'desc'

## Response `200`

Export analytics data for search segmentations and lists.

- object
  - `data` object[], required
    - `count` number, required
    - `name` string, required
    - `percentageOfAll` number, required
    - `percentageOfTotal` number, required
  - `meta` object, required
    - `listId` number
    - `query` SegmentationCondition[], required
      - `attribute` 'about.businessType' | 'about.industries' | 'about.industry' | 'about.name' | 'about.totalEmployees' | 'about.yearFounded' | 'ai.search' | 'analytics.monthlyVisitors' | 'apps' | 'codes.naics' | 'codes.sic' | 'contacts' | 'domain.domain' | 'domain.tld' | 'finances.revenue' | 'finances.stockExchange' | 'locations.headquarters.city.code' | 'locations.headquarters.continent.code' | 'locations.headquarters.country.code' | 'locations.headquarters.county.code' | 'locations.headquarters.state.code' | 'meta.listIds' | 'meta.score' | 'meta.syncedAt' | 'socials' | 'socials.linkedin.id' | 'technologies.active' | 'technologies.categories' | 'urls', required
      - `blockedOperator` boolean
      - `operator` 'and' | 'or', required
      - `sign` 'equals' | 'exactEquals' | 'greater' | 'lower' | 'notEquals', required
      - `values` union[], required
        - union
          - string
          - number
    - `totalDatapoints` number, required
    - `totalDocuments` number, required
    - `totalValues` number, required

## Other responses

- `401`: The error message

---

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