Exporting post content or subscriber data from beehiiv

Post content and information you’ve collected about your subscribers can easily be exported as a .csv file from your beehiiv account for analysis or other purposes. 

Subscriber data can be exported in two formats: Quick or Full. Both provide a list of subscribers by email, status, and tier, sorted by the most recent subscriptions. However, the Full export includes additional details like custom fields and statistics, though it may take a bit longer to process.

These export options are located in your publication settings. This article will first explain how to export your post content and then walk you through both Quick and Full subscriber export options.

Tech Note: Exported post content contains data on all posts; published, archived, and in draft. Download links for exported data are valid for 24 hours. If the link expires, you’ll need to request the export again following these steps.

How to export your post content 

  1. From the left panel Dashboard, scroll down and select Settings.
     
  2. Your publication settings will open on General Info. If you have multiple publications, select one from the dropdown options. Click Export Data

  3. Under Export Posts, click Export All Posts. 

  4. A quick success message will appear to tell you that you will receive an email when your export is ready.

  5. Your export request will appear below under Historical Exports. It will show as Processing until your export is complete. 

  6. When your export has finished, you will receive an email with a direct link to download your export.

  7. You can also refresh the Export Data page. When the file is completed, in the Historical Exports section, a Download link will appear next to your request.


How to export your subscriber data (Quick or Full)

  1. From the left panel Dashboard, scroll down and select Settings.
     
  2. Your publication settings will open on General Info. If you have multiple publications, select one from the dropdown options. Click Export Data

  3. Under Export Subscribers, click either Export All Basic Subscribers (for the Quick Version) or Export All Subscribers (for the Full Version with more data points).

  4. A quick success message will appear to tell you that you will receive an email when your export is ready.

  5. Your export request will appear below under Historical Exports. It will show as Processing until your export is complete. 

  6. When your export has finished, you will receive an email with a direct link to download your export.

  7. You can also refresh the Export Data page. When the file is completed, in the Historical Exports section a Download link will appear next to your request.


Exporting subscriber data via the API

If you'd rather trigger subscriber exports programmatically instead of through the beehiiv dashboard, you can use the beehiiv API's Subscription Export endpoint.

Note: This is a gated feature and requires enabling for your publication. Please use the chatbot to help you reach out to beehiiv support, or access the Help page in your account, to request access before using this endpoint.

Once enabled, you can request an export by sending a POST request to:

https://api.beehiiv.com/v2/publications/{publication_id}/exports/subscriptions

with a Bearer token in the Authorization header. The request body accepts:

  • variant (required): either full or basic, matching the Quick and Full export options available in the dashboard.
  • segment_id (optional): limits the export to a specific segment. Leave this out to export all subscribers.

Exports process asynchronously. The response returns an export object with a status field (for example, "pending") and a download_url field that populates once the export finishes. If you send an identical request while a matching export is already in progress, the API returns that existing export instead of starting a duplicate.

Tech Note: The Subscription Export API currently supports subscriber data only. To export post content, use the Export All Posts option described above.

For full parameter and response details, see beehiiv's API reference for the Create Export endpoint.


Was this article helpful?

Related Articles