---
title: "Export audience companies to CSV"
method: POST
path: "/v1/audiences/{audienceId}/export/companies"
tags: ["Audiences"]
---

# Export audience companies to CSV

`POST /v1/audiences/{audienceId}/export/companies`

## Request

- Base URL: `https://api.fiber.ai`
- URL: `https://api.fiber.ai/v1/audiences/{audienceId}/export/companies`
- Auth: none declared

Triggers CSV export of companies in an audience. The export runs asynchronously - CSV links will be sent to the provided email address (if userEmail is provided) or returned in the API response. Export quota limits apply per usage period.

<span>⚡ <strong>Rate limit:</strong> 120 requests per 1 minute</span>

<span>💰 <strong>Cost:</strong> FREE! No credits are charged for this API.&nbsp;<span title="Pricing shown is default pricing. Actual pricing may vary.">ⓘ</span></span>

## Path parameters

- `audienceId` string, required

## Request body

- object
  - `apiKey` string, required: Your Fiber API key
  - `format` 'PROSPECT_GENERIC_CSV' | 'PROSPECT_LI_ADS_CSV' | 'PROSPECT_GOOGLE_ADS_CSV' | 'PROSPECT_META_ADS_CSV' | 'COMPANY_GENERIC_CSV' | 'COMPANY_LI_ADS_CSV' | 'LI_PROFILE_URL_FIXUP' | 'LI_COMPANY_URL_FIXUP' | 'GOOGLE_MAPS_CSV' | 'DOMAIN_AGENT_CSV' | 'MOSAIC_CSV', required: The format of the exported file.
  - `maxRowsToExport` integer, nullable: Maximum number of rows to export. Defaults to your remaining export quota for the usage period; an export never exceeds 1,000,000 rows. Large exports are split across several files.
  - `excludeFields` string[]: The fields to exclude from the export.
  - `userEmail` string, email, nullable: Optional email address to receive CSV export links. If not provided, no email will be sent.

## Response `200`

Default Response

- object
  - `output` object, required
    - `message` string, required: A human-readable message about the export status.
    - `estimatedRows` number, required: The estimated number of rows that will be exported.
    - `maxRowsAllowed` number, required: The maximum rows allowed based on the export quota.
  - `chargeInfo` union, required
    - object: Credits were charged immediately for this operation
      - `method` 'charged-now', required
      - `creditsCharged` number, required
      - `lowCreditAlert` object, nullable: Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required: URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required: Human-readable credits warning.
        - `availableCredits` number, required: Number of credits remaining in the current billing period.
    - object: Credits will be charged after the operation completes
      - `method` 'charging-later', required
      - `message` string, required
      - `lowCreditAlert` object, nullable: Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required: URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required: Human-readable credits warning.
        - `availableCredits` number, required: Number of credits remaining in the current billing period.
    - object: Credits that were charged for an asynchronous operation
      - `method` 'charged-for-async-process', required
      - `creditsCharged` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable: Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required: URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required: Human-readable credits warning.
        - `availableCredits` number, required: Number of credits remaining in the current billing period.
    - object: No credits were charged for this operation
      - `method` 'free', required
      - `message` string, required
      - `lowCreditAlert` object, nullable: Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required: URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required: Human-readable credits warning.
        - `availableCredits` number, required: Number of credits remaining in the current billing period.
    - object: Credits were refunded for this operation
      - `method` 'credits-refunded', required
      - `creditsRefunded` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable: Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required: URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required: Human-readable credits warning.
        - `availableCredits` number, required: Number of credits remaining in the current billing period.
  - `warnings` object[], nullable: Warnings about extraneous fields in request
    - `field` string, required: Full path to extraneous field (e.g., 'searchParams.ExtraField')
    - `message` string, required: Warning message
  - `advice` string[], nullable: Tips, recommendations, and suggestions for using this API effectively.

## Other responses

- `400`: Default Response
- `401`: Default Response
- `402`: Default Response
- `403`: Default Response
- `404`: Default Response
- `422`: Default Response
- `429`: Default Response
- `500`: Default Response
- `503`: Default Response

## Changes

- **2026-07-31** `4002aa81d4fb`: 2 breaking, 1 info
  - the response property `advice` became nullable for the status `200`
  - the response property `advice` became optional for the status `200`
  - the `advice` response's property default value `` was removed for the status `200`
- **2026-07-26** `fda5277ff34f`: 1 info
  - added the new `MOSAIC_CSV` enum value to the request property `format`
- **2026-07-13** `f14ac2efab0c`: 2 info
  - added the non-success response with the status `422`
  - added the required property `advice` to the response with the `200` status

[Operation history](https://skmtc.dev/fiber/apis/fiber-ai-api/changes/v1/audiences/:audienceId/export/companies/post.md)

---

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