---
title: "Create Data Export"
method: POST
path: "/api/data-exports"
tags: ["Data Exports"]
---

# Create Data Export

`POST /api/data-exports`

Create a new data export request. This will calculate the required credits and prepare the export for starting.

## Request body

- object
  - `type` 'transactions' | 'chat_messages' | 'media_vault' | 'trial_links' | 'tracking_links' | 'smart_links' | 'payouts' | 'chargebacks' | 'public_profiles' | 'fans' | 'followings', required — The type of data to export
  - `account_ids` string[] — Array of account prefixed IDs to export data from. Not required for `public_profiles` type.
  - `start_date` string, required — The start date for the export (ISO 8601 format).
  - `end_date` string, required — The end date for the export (ISO 8601 format).
  - `export_columns` string[] — Array of column names to include in the export (optional, defaults to all columns for the export type)
  - `file_type` 'csv' | 'xlsx' | 'zip', required — The output file format. Supported formats vary by export type: `csv` or `xlsx` for transactions, chat_messages, trial_links, tracking_links, smart_links, payouts, chargebacks, public_profiles, fans, followings; `zip` for media_vault.
  - `options` object — Type-specific export options. For `chat_messages`: `maxMessages` (required per account, max 10,000,000), `maxChats` (optional per-account chat scrape limit), `skipMassMessages` (optional, bool), `chatIds` (optional array of numeric fan/chat IDs; filters output and can drastically reduce totals). For `media_vault`: `mediaType` (required, one of: `all`, `photo`, `gif`, `video`, `audio`). For `fans`: `type` (required, one of: `all`, `active`, `expired`, `latest`). For `followings`: `type` (required, one of: `all`, `active`, `expired`). For `public_profiles`: `query` (optional, full-text search), `gender` (optional, filter: male, female, trans, couple), `minSubscribePrice` (optional, USD), `maxSubscribePrice` (optional, USD), `location` (optional), `minPostsCount` (optional, minimum posts), `minPhotosCount` (optional, minimum photos), `minVideosCount` (optional, minimum videos), `minSubscribersCount` (optional, minimum subscribers), `minJoinDate` (optional, ISO 8601 date), `minLastSeenAt` (optional, ISO 8601 date), `createdAtFrom` (optional, ISO 8601 date, profile added to DB after), `createdAtTo` (optional, ISO 8601 date, profile added to DB before), `instagram` (optional), `twitter` (optional), `tiktok` (optional), `maxResults` (optional, limit results).
  - `auto_start` boolean — When true, automatically starts the export after creation.

## Response `200`

Success

- object
  - `data` object
    - `id` string
    - `type` string
    - `status` string
    - `start_date` string
    - `end_date` string
    - `file_type` string
    - `created_at` string
    - `requires_scraping` boolean
    - `credit_calculation_note` string
  - `_meta` object
    - `_credits` object
      - `used` integer
      - `balance` integer
      - `note` string
    - `_cache` object
      - `is_cached` boolean
      - `note` string
    - `_rate_limits` object
      - `limit_minute` integer
      - `limit_day` string, nullable
      - `remaining_minute` integer
      - `remaining_day` string, nullable
      - `notice` string

---

[API](https://skmtc.net/onlyfansapi/apis/onlyfans-api.md) · [All operations](https://skmtc.net/onlyfansapi/apis/onlyfans-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onlyfansapi/onlyfans-api/revisions/4a99d36f28a3/schema)