> **For AI agents:** this page is a focused, LLM-optimized view of a
> single Fiber AI operation. Before calling it, fetch the routing
> instructions at [`https://api.fiber.ai/llms.txt`](https://api.fiber.ai/llms.txt) and the full operation
> index at [`https://api.fiber.ai/ai-docs/index.md`](https://api.fiber.ai/ai-docs/index.md).

# exportCompanies

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

**Tags:** `Audiences`

Export audience companies to CSV

**Endpoint:** `https://api.fiber.ai/v1/audiences/{audienceId}/export/companies`

## Description

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.

⚡ Rate limit: 120 requests per 1 minute

💰 Cost: FREE! No credits are charged for this API. ⓘ

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `audienceId` | path | yes | The unique ID of the audience. |

## Request body (JSON Schema)

```json
{
  "type": "object",
  "properties": {
    "apiKey": {
      "type": "string",
      "description": "Your Fiber API key"
    },
    "format": {
      "type": "string",
      "enum": [
        "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"
      ],
      "description": "The format of the exported file."
    },
    "maxRowsToExport": {
      "type": [
        "integer",
        "null"
      ],
      "exclusiveMinimum": 0,
      "description": "Maximum number of rows to export. Defaults to remaining export quota."
    },
    "excludeFields": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "fiber_id",
          "name",
          "all_names",
          "website",
          "domain",
          "linkedin_url",
          "linkedin_org_id",
          "logo_url",
          "headline",
          "description",
          "standard_industries",
          "linkedin_industries",
          "naics_codes",
          "hq_full_address",
          "hq_street_address",
          "hq_city",
          "hq_state",
          "hq_country",
          "hq_country_code",
          "hq_latitude",
          "hq_longitude",
          "num_offices",
          "all_office_addresses",
          "office_countries",
          "category",
          "employee_count_lower",
          "employee_count_upper",
          "founded_on",
          "num_followers",
          "office_locations",
          "office_locations_raw",
          "funding_stage",
          "last_funded_at",
          "last_funding_usd",
          "total_funding_usd",
          "market_cap_usd",
          "revenue_usd",
          "accelerators",
          "investors",
          "acquisitions",
          "funding_rounds",
          "stock_ticker",
          "num_exits",
          "tags",
          "job_posting_stats",
          "specialties",
          "phone_numbers",
          "facebook_urls",
          "x_urls",
          "github_usernames",
          "wellfound_urls",
          "blog_urls",
          "instagram_urls",
          "youtube_urls",
          "short_description",
          "long_description",
          "roles",
          "primary_role",
          "is_subsidiary",
          "parent",
          "matching_job_posting_urls",
          "matching_job_postings_json",
          "matching_job_postings_titles",
          "num_matching_job_postings",
          "num_role_matches",
          "custom"
        ]
      },
      "default": [],
      "description": "The fields to exclude from the export."
    },
    "userEmail": {
      "type": [
        "string",
        "null"
      ],
      "format": "email",
      "description": "Optional email address to receive CSV export links. If not provided, no email will be sent."
    }
  },
  "required": [
    "apiKey",
    "format"
  ]
}
```

## Response — success (JSON Schema)

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

---

Canonical JSON: [`https://api.fiber.ai/openapi.json`](https://api.fiber.ai/openapi.json)
Operation index: [`https://api.fiber.ai/ai-docs/index.md`](https://api.fiber.ai/ai-docs/index.md)