How to Use the Instagram Story Viewers Export

Sophie
Sophie This badge shows you’re hearing straight from the source! Team members are here to share insider tips, answer questions, and guide you through PhantomBuster with expert knowledge. They’re dedicated to helping you succeed and making sure your automation journey feels easy and exciting. PhantomBuster Official
  • Updated

Slot usage

1 slot

Estimated execution time

Around 25 seconds per 200 viewers

What you'll need

What you’ll get

  • Viewer username, profile URL, and follow relationship info
  • Story media URL

    → See the full breakdown of all output fields in the detailed section below.

Before you start

  • This Phantom can only extract viewers from your current active stories. Once your stories expire, their viewer data cannot be retrieved.

Step 1: Connect your Instagram account

To let the Phantom act on your behalf:

  1. Install the PhantomBuster browser extension and connect your Instagram session in one click.
  2. If you’re not using Chrome or Firefox, you can retrieve your session cookie manually (see our cookie guide).
PhantomBuster Instagram Story Viewers Export step 1 connecting your Instagram account

Step 2: Configure your results

  1. Name your results file (optional)
    • You can customize the file name.

      If you rename the file between launches, the Phantom will create a new results file and start processing inputs from scratch.

  2. Fields to keep (optional)
PhantomBuster Instagram Story Viewers Export step 2 configuring your results

Step 3: Select launch frequency

Choose how often the Phantom should run:

  1. Launch manually: Start the Phantom yourself whenever you need.
  2. Launch once at a specific time: schedule a one-time run at a set date and time.
  3. Launch repeatedly: schedule regular runs (e.g. once per day, several times during working hours).
  4. Launch after another Phantom: chain automations together so this Phantom starts right after another finishes.
  5. Advanced scheduling: customize the exact minutes, hours, days, or months when the Phantom should run.

→ For a complete walkthrough of scheduling options, see our guide to scheduling Phantoms automatically.

PhantomBuster Instagram Story Viewers Export step 3 selecting launch frequency

Step 4 (Optional): Advanced settings

Advanced settings are available if you want to fine-tune how your Phantom runs, but by default they’re already optimized for most use cases.

We recommend leaving them as they are unless a guide specifically instructs you to change something.

→ For a detailed overview of all advanced options (like execution limits, retries, email notifications, proxies, webhooks, and file management), see our Advanced settings guide.

Launch and results

When you’re ready:

  1. Click Launch to start your Phantom.
  2. Once it finishes, open the Results tab in the Phantom console to see the data collected.
  3. Download your results as a CSV or JSON file.

To learn how to export your data to Google Sheets, integrate with other tools, or reuse it in more automations, check our Access and Export your Phantom Results guide.

Export and input limits on the Free plan
If you’re on the Free plan or Free trial, some features are limited:
- CSV exports include only the first 10 rows of results.
- CSV download links (for dynamic viewing in Google Sheets or integrations) are not available.
- JSON exports are not available.
- CSV upload as an input method is not supported.
To unlock all features, you’ll need to upgrade to a paid plan.

What you give (Input) and What you get (Output)

This section gives you a detailed breakdown of everything you need to provide to run this Phantom, and everything you’ll receive once it completes.

What you give (Input)

Type Description
Instagram cookie Your Instagram session cookie

What you get (Output)

Type Description
displayUrl The content's URL
pubdate The viewer's date of viewing
owner The story's owner
username The viewer's username
profileUrl The viewer's profile URL
type Photo or video
followedByViewer Whether the viewer follows the story owner or not

Tips and troubleshooting

Common pitfalls

  • Expired stories: This Phantom only works with stories currently live on your account. Once they disappear, their viewer lists can’t be retrieved.

If you run into errors or account issues

Suggested automations

Was this article helpful?

0 out of 0 found this helpful