Instagram Story Details Scraper

Instagram Story Details Scraper

The Instagram Story Details Scraper is a purpose-built web scraper for Instagram stories that extracts structured story metadata at scale. It solves the pain of manual capture by turning each story into a clean JSON/CSV row with fields like IDs, timestamps, media URLs, and enriched metadata — ideal for marketers, developers, data analysts, and researchers. As an Instagram story scraper and Instagram story metadata scraper, it enables automated Instagram story data collection, bulk Instagram story scraping, and API-ready exports for downstream workflows.

What data / output can you get?

Below are examples of real fields the actor saves for each story. Each item is pushed as a single row into the run’s dataset, ready for Instagram story data export CSV/JSON/Excel.

Data type	Description	Example value
pk	Primary key of the story item	"3132259876543212345"
id	Story media ID	"3132259876543212345_1234567890"
code	Shortcode/identifier for the story	"C5XyZ1A1234"
media_type	Media type (image/video numeric flag)	2
taken_at	Unix timestamp when the story was taken	1714212345
expiring_at	Unix timestamp when the story expires	1714298745
user.id	Author’s user ID	"1234567890"
user.username	Author’s username	"exampleuser"
image_versions2.candidates[0].url	Image URL for photo stories	"https://scontent.cdninstagram.com/.../photo.jpg?..."
video_versions[0].url	Video URL for video stories	"https://scontent.cdninstagram.com/.../video.mp4?..."
video_duration	Video duration in seconds	14.25
has_audio	Whether the video has audio	true
music_metadata.music_asset_info	Music metadata inferred from stickers (when present)	{"title":"Song name","artist":"Artist"}
can_reply	Whether replies are allowed	true
can_reshare	Whether reshares are allowed	false
is_viewer_mentioned	Whether your account is mentioned	false
story_music_stickers	Raw music sticker data (if present)	[...]

Notes:

• The actor preserves the original story item structure and orders important keys first. It also enriches media objects with url_expiration_timestamp_us when possible.
• Bonus outputs include any additional fields returned by Instagram’s story payload (e.g., captions, crosspost metadata), plus enrichment of video URL objects.
• Export your dataset to JSON, CSV, or Excel directly from Apify when the run finishes.

Key features

• 🎯 Enriched media URLs — Adds url_expiration_timestamp_us to nested media URLs when available, making this an accurate Instagram story details extractor for downstream processing.
• 🎵 Smart music metadata — Infers music_metadata from story_music_stickers if not already provided, boosting coverage for audio insights.
• ⚡ Live dataset appends — Each story is written immediately with Actor.push_data, so you can monitor progress in the Output tab in real time.
• 🧰 Bulk scraping at scale — Supply multiple profile URLs/usernames in one run; the actor paces itself with a 5-second pause between profiles for stability in automated Instagram story data collection.
• 🛡️ Resilient proxy fallback — Built-in fallback logic leverages Apify Proxy (including SHADER and RESIDENTIAL groups) to reduce blocks and improve reliability for a web scraper for Instagram stories.
• 💾 API-ready exports — Clean dataset output suitable for pipelines, dashboards, or BI tools; ideal for an Instagram stories API scraper workflow.
• 👩‍💻 Developer friendly — Run via the Apify API/SDK and connect results to Make, n8n, Zapier, or your Python stack for IG story scraper tool automations.
• 🔐 Session-based accuracy — Uses your instagram.com sessionid cookie to fetch exactly what your account can see, aligning with normal viewing permissions.

How to use Instagram Story Details Scraper - step by step

1. Sign in to Apify.
2. Open the Instagram Story Details Scraper actor.
3. Prepare your session cookie: from a logged-in instagram.com session, copy the sessionid cookie value.
4. Add input data:
   • urls: paste Instagram profile URLs or plain usernames (with or without @). You can add several for bulk Instagram story scraping.
   • sessionId: paste your sessionid cookie value.
   • proxyConfiguration (optional): keep Apify Proxy on for smoother runs, especially with larger batches.
5. Start the run. The actor warms up your session, then processes each profile, waiting 5 seconds between profiles for stability.
6. Watch live results in the Output tab. Rows appear as stories are saved.
7. Download your results. Export the dataset to JSON, CSV, or Excel for analytics or integration.

Pro tip: Orchestrate scheduled runs and pull datasets via the Apify API to power automated Instagram story data export CSV workflows in your data pipeline.

Use cases

Use case name	Description
Marketing + campaign tracking	Measure story cadence and creative elements across competitors. Export to CSV for performance comparisons.
Influencer monitoring	Aggregate creator story metadata into dashboards for brand partnerships and content analysis.
Content strategy research	Collect timestamps, media types, and music usage to inform editorial planning for IG story formats.
Academic / social media research	Build datasets of story activity over time for studies on ephemeral media behavior.
API pipeline enrichment	Feed story metadata into ETL/ELT jobs and analytics stores using the Apify API.
Bulk Instagram story scraping for audits	Process many profiles per run to maintain fresh, structured evidence of brand or competitor activity.

Why choose Instagram Story Details Scraper?

A precise, automation-ready Instagram story metadata scraper that prioritizes structure, enrichment, and reliability over brittle browser automation.

• ✅ Complete story payloads: Preserves original fields and orders key metadata up front for consistent downstream use.
• 🎵 Metadata enrichment: Infers music_metadata and enriches media URLs with expiration timestamps where possible.
• 📦 Built for batches: Handles multiple profiles with sensible pacing to support large-scale workflows.
• 🧩 Developer access: Integrate via Apify’s API/SDK and automate exports to your stack or no-code tools.
• 🛡️ Reliable infrastructure: Optional Apify Proxy plus built-in fallback logic for more stable runs.
• 💰 Efficient exports: Download JSON, CSV, or Excel without manual copy/paste.
• 🧠 Better than extensions: Avoid flaky UI scraping — this approach focuses on structured responses and robust request patterns.

In short, it’s an Instagram stories API scraper alternative optimized for accuracy, enrichment, and automation-readiness.

Is it legal / ethical to use Instagram Story Details Scraper?

Yes — when used responsibly. This actor accesses story data using your logged-in session and only returns what your account can normally see.

Guidelines to follow:

• Respect platform terms and applicable laws (e.g., GDPR/CCPA).
• Only collect data you’re allowed to access and store.
• Treat your sessionId like a password; never share it publicly.
• Consult your legal team for edge cases or commercial usage questions.

The tool does not bypass protections; it operates with your session, mirroring normal access.

Input parameters & output format

Example input

{
  "urls": [
    "https://www.instagram.com/kyliejenner/",
    "exampleuser",
    "@anotheruser"
  ],
  "sessionId": "YOUR_INSTAGRAM_SESSIONID_COOKIE",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Parameters

Field	Type	Required	Default	Description
urls	array	Yes	Not specified	Profile URLs or plain usernames (with or without @). Supports batching.
sessionId	string	Yes	""	Your instagram.com sessionid cookie. Used to access content your account can see.
proxyConfiguration	object	No	Prefill uses {"useApifyProxy": true}	Optional Apify Proxy for smoother, more stable runs.

Example output (one dataset item per story)

{
  "pk": "3132259876543212345",
  "id": "3132259876543212345_1234567890",
  "is_visual_reply_commenter_notice_enabled": false,
  "like_and_view_counts_disabled": false,
  "is_post_live_clips_media": false,
  "is_reshare_of_text_post_app_media_in_ig": false,
  "is_reel_media": false,
  "fbid": "17890123456789012",
  "device_timestamp": 1714212330,
  "caption_is_edited": false,
  "strong_id__": "3132259876543212345",
  "deleted_reason": 0,
  "expiring_at": 1714298745,
  "should_request_ads": false,
  "taken_at": 1714212345,
  "media_type": 2,
  "code": "C5XyZ1A1234",
  "caption": null,
  "user": {
    "id": "1234567890",
    "username": "exampleuser",
    "full_name": "Example User"
  },
  "image_versions2": {
    "candidates": [
      {
        "url": "https://scontent.cdninstagram.com/v/t51.2885-15/....jpg?...&oe=660ABCDE",
        "width": 1080,
        "height": 1920
      }
    ]
  },
  "original_width": 1080,
  "original_height": 1920,
  "product_type": "feed",
  "music_metadata": {
    "music_asset_info": {
      "title": "Song name",
      "artist": "Artist",
      "display_artist": "Artist"
    }
  },
  "story_music_stickers": [
    {
      "music_asset_info": {
        "title": "Song name",
        "artist": "Artist"
      }
    }
  ],
  "video_versions": [
    {
      "type": 101,
      "url": "https://scontent.cdninstagram.com/o1/v/t16/f1/m82/....mp4?...&oe=660ABCDE",
      "width": 720,
      "height": 1280,
      "url_expiration_timestamp_us": 1734567890000000
    }
  ],
  "video_duration": 14.25,
  "has_audio": true,
  "can_reply": true,
  "is_viewer_mentioned": false,
  "can_reshare": false
}

Notes:

• The scraper pushes each story as it’s found using Actor.push_data, so rows appear live in the dataset.
• Fields depend on what Instagram returns for each story; some may be missing or null (e.g., music_metadata for non-music stories, video_versions for image stories).
• The actor enriches nested media URLs with url_expiration_timestamp_us when possible and may infer music_metadata from story_music_stickers.

FAQ

Do I need to log in or provide cookies?

✅ Yes. You must provide your instagram.com sessionId (the sessionid cookie). The scraper uses this to access the same stories your account can normally see.

Can I scrape multiple Instagram profiles at once?

✅ Yes. Add multiple profile URLs or usernames to urls for bulk Instagram story scraping. The actor automatically waits 5 seconds between profiles to keep runs stable.

What kinds of story data does this collect?

🧩 It preserves the story item’s JSON structure, including fields like pk, id, code, media_type, taken_at, user details, image/video URLs, durations, music metadata (when present), and policy flags. Additional fields from Instagram’s response are included as-is.

Does it collect viewer lists or insights?

❌ No. This tool focuses on story metadata. It does not fetch viewer lists; if you need an Instagram story viewer list scraper, consider complementary tools built specifically for that purpose.

How soon do results appear and where can I export them?

⚡ Results are appended live to your run’s default dataset. Open the Output tab during the run and refresh to see new rows. Export to JSON, CSV, or Excel when finished.

Do I need to configure a proxy?

🛡️ It’s optional but recommended for larger batches. You can enable Apify Proxy in proxyConfiguration. The actor also includes built-in fallback logic to improve reliability.

Can I integrate this with my data pipeline or API?

💻 Yes. Run the actor via the Apify API/SDK and pull the dataset programmatically. This makes it a great fit for IG story scraper tool automations and workflow orchestration with Make or n8n.

What happens if a profile has no active stories?

ℹ️ The actor will log that nothing new was found for that profile and move on. No rows are added in that case.

Closing CTA / Final thoughts

Built for structured, reliable Instagram story details extraction, this actor turns ephemeral stories into analysis-ready data. With live dataset appends, enrichment of media URLs and music metadata, and batch-friendly inputs, it’s ideal for marketers, developers, analysts, and researchers. Use the Apify API to trigger runs and export JSON/CSV/Excel for seamless automation — start extracting smarter with a production-ready Instagram story details extractor today.

What are other Instagram scraping tools?

If you want to scrape specific Instagram data, you can use any of the dedicated scrapers below for faster and more targeted results.

Scraper Name	Scraper Name
Instagram B2b Email Scraper	Instagram Post Details Scraper
Instagram B2b Lead Scraper	Instagram Posts Scraper
Instagram B2b Phone Number Scraper	Instagram Profile Email Scraper
Instagram Comments Scraper	Instagram Profile Email Scraper By Keyword
Instagram Dm Automation	Instagram Profile Lead Scraper
Instagram Email Scraper	Instagram Profile Lead Scraper By Keyword
Instagram Followers And Following Scrapper	Instagram Profile Phone Number Scraper
Instagram Followers Count Scraper	Instagram Profile Phone Number Scraper By Keyword
Instagram Followers Scraper	Instagram Profile Post Scraper
Instagram Following Scraper	Instagram Profile Reels Scraper
Instagram Hashtag Scraper	Instagram Profile Scraper
Instagram Hashtag Username Scraper	Instagram Reels Scraper
Instagram Highlights Scraper	Instagram Related Hashtag Stats Scraper
Instagram Lead Scraper	Instagram Related Person Scraper
Instagram Likes Scraper	Instagram Single Reels Scraper
Instagram Location Scraper	Instagram Tagged Mentions Posts Scraper
Instagram Mentions Scraper	Instagram Tagged Posts Scraper
Instagram Phone Number Scraper