How can I export user segment data from Pushwoosh via API for use in external systems?

You can export user or device data for a specific segment using the Pushwoosh API, for example to feed a data warehouse (Google BigQuery), a CRM, or cloud storage.

The export is a two-step, asynchronous process:

1. POST https://api.pushwoosh.com/api/v2/audience/exportSegment — starts the export. Send your API access token in auth, the segment in filterExpression (or a pre-made filterCode), plus applicationCode. Optional parameters include exportData (hwids, push_tokens, users, tags, location), tagsList, format (csv or json_each_line), includeWithoutTokens and generateExport. The response contains a task_id.

   • Documentation: /exportSegment

2. POST https://api.pushwoosh.com/api/v2/audience/exportSegment/result — send auth and the task_id from step 1 to retrieve the result. The response returns devicesCount and filename — a link to a ZIP archive that unpacks to the CSV or JSON file (per the format you requested).

   • Documentation: /exportSegment results

Downloading the file requires authorization. Since 3 April 2025 the export link is protected: in a browser, simply be logged in to the Pushwoosh Control Panel; from server-side software, send the header Authorization: Token YOUR_API_TOKEN.

Other considerations

• By default the export contains HWID, User ID, push token, platform type, and the default tags (Age, Application Version, City) plus any account tags. Use exportData/tagsList to narrow it down.
• User and device data is volatile: push tokens are removed when an app is uninstalled and long-inactive devices are pruned, so your integration should treat each export as a snapshot rather than a stable key set.