Skip to main content
How to export segments

Learn how to export Nosto segments to other systems

Maxime Pasquier avatar
Written by Maxime Pasquier
Updated over 6 months ago

Nosto supports different types of data export mechanisms, each useful for different types of use cases.

Using the Segment Export Functionality

Segment export is likely most useful when the target use case is to use Nosto segment data in a 3rd party system such as in ESP, CDP, CRM or similar as it supports full periodical data export of all shopper identities and emails that Nosto processes.

Enabling the Segment Export

In the Segment Export area under Settings->Integrations, start by adding a segment identifier. Identifier allows identifying the source of the data easily in the target system later on.

For example, if the value is “nosto_segments”, the file output will include the detail as in the example below. You can choose the identifier freely, but we recommend using naming which identifies Nosto as the source. The Identifier can be changed later on, which will simply update the values in the next periodical export.

Example of the output, three emails and associated example segments

{"email":"jonathan.doe@gmail.com","nosto_segments":["Prospects", "Nike fans", "UTM-tag Instagram"]}

{"email":"jane.doe@hotmail.com,"nosto_segments":["First Time Buyer", "Adidas fans", "jacket category affinity", "geo-area Germany"]}

{"email":"john.smith@company.com","nosto_segments":["Loyal customers", "Timberland fans", "geo-area New York"]}

Clicking enable starts the periodical file creation, which takes place within the next 24hrs after enabling the first sync. Integration token is created immediately and made available. File format is .json and it is created once per day by including all the emails processed by Nosto until the date.

Note that if you’re testing on a staging environment and associated Nosto account, the export file is empty if the account does not have any customer data.

Guidelines to Build the Integration: Fetching the Segment File

Make a GET request to https://api.nosto.com/segments/export with basic http authorization nosto:<token>

Retrieved payload is .json including emails and segments as in the example

Querying identities by using GraphQL

Using GraphQL is likely most useful when the use case is retrieving individual segment records instead of a mass export. GraphQL documentation available here.

Manual Segment Export as .csv

Manual segment export creates a .csv file that can be exported on-demand basis. Manual export is likely most useful when the use case is to debug segments or to create a stand-alone targeting audience in another service, which is not updated frequently.

Select a segment and export

Go to the segment listing view, select the segment you want to export, click on Export and then select Email addresses.


Once redirected to the email export tool, you can adjust the date range to export email addresses of customers who belong to this segment in the past 30 days, past 7 days or select a custom date range and click on Save and Export.

You can also go here directly over Settings->Tools->Emails->Email Export.


After being initiated, an email notification will be sent to the account owner of the Nosto Admin Panel and a download link is available.

Did this answer your question?