# Instagram Story Details Scraper (`scrapier/instagram-story-details-scraper`) Actor

📸 Instagram Story Details Scraper extracts rich Story metadata—timestamps, views, replies, stickers, links, mentions, hashtags, media URLs & user IDs—into clean JSON/CSV. 🚀 Perfect for competitive analysis, campaign tracking, and content strategy. Fast, reliable, API-ready.

- **URL**: https://apify.com/scrapier/instagram-story-details-scraper.md
- **Developed by:** [Scrapier](https://apify.com/scrapier) (community)
- **Categories:** Social media, Developer tools, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.99 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

### 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
```json
{
  "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)

```json
{
  "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](https://apify.com/scrapier/instagram-b2b-email-scraper) | [Instagram Post Details Scraper](https://apify.com/scrapier/instagram-post-details-scraper) |
| [Instagram B2b Lead Scraper](https://apify.com/scrapier/instagram-b2b-lead-scraper) | [Instagram Posts Scraper](https://apify.com/scrapier/instagram-posts-scraper) |
| [Instagram B2b Phone Number Scraper](https://apify.com/scrapier/instagram-b2b-phone-number-scraper) | [Instagram Profile Email Scraper](https://apify.com/scrapier/instagram-profile-email-scraper) |
| [Instagram Comments Scraper](https://apify.com/scrapier/instagram-comments-scraper) | [Instagram Profile Email Scraper By Keyword](https://apify.com/scrapier/instagram-profile-email-scraper-by-keyword) |
| [Instagram Dm Automation](https://apify.com/scrapier/instagram-dm-automation) | [Instagram Profile Lead Scraper](https://apify.com/scrapier/instagram-profile-lead-scraper) |
| [Instagram Email Scraper](https://apify.com/scrapier/instagram-email-scraper) | [Instagram Profile Lead Scraper By Keyword](https://apify.com/scrapier/instagram-profile-lead-scraper-by-keyword) |
| [Instagram Followers And Following Scrapper](https://apify.com/scrapier/instagram-followers-and-following-scrapper) | [Instagram Profile Phone Number Scraper](https://apify.com/scrapier/instagram-profile-phone-number-scraper) |
| [Instagram Followers Count Scraper](https://apify.com/scrapier/instagram-followers-count-scraper) | [Instagram Profile Phone Number Scraper By Keyword](https://apify.com/scrapier/instagram-profile-phone-number-scraper-by-keyword) |
| [Instagram Followers Scraper](https://apify.com/scrapier/instagram-followers-scraper) | [Instagram Profile Post Scraper](https://apify.com/scrapier/instagram-profile-post-scraper) |
| [Instagram Following Scraper](https://apify.com/scrapier/instagram-following-scraper) | [Instagram Profile Reels Scraper](https://apify.com/scrapier/instagram-profile-reels-scraper) |
| [Instagram Hashtag Scraper](https://apify.com/scrapier/instagram-hashtag-scraper) | [Instagram Profile Scraper](https://apify.com/scrapier/instagram-profile-scraper) |
| [Instagram Hashtag Username Scraper](https://apify.com/scrapier/instagram-hashtag-username-scraper) | [Instagram Reels Scraper](https://apify.com/scrapier/instagram-reels-scraper) |
| [Instagram Highlights Scraper](https://apify.com/scrapier/instagram-highlights-scraper) | [Instagram Related Hashtag Stats Scraper](https://apify.com/scrapier/instagram-related-hashtag-stats-scraper) |
| [Instagram Lead Scraper](https://apify.com/scrapier/instagram-lead-scraper) | [Instagram Related Person Scraper](https://apify.com/scrapier/instagram-related-person-scraper) |
| [Instagram Likes Scraper](https://apify.com/scrapier/instagram-likes-scraper) | [Instagram Single Reels Scraper](https://apify.com/scrapier/instagram-single-reels-scraper) |
| [Instagram Location Scraper](https://apify.com/scrapier/instagram-location-scraper) | [Instagram Tagged Mentions Posts Scraper](https://apify.com/scrapier/instagram-tagged-mentions-posts-scraper) |
| [Instagram Mentions Scraper](https://apify.com/scrapier/instagram-mentions-scraper) | [Instagram Tagged Posts Scraper](https://apify.com/scrapier/instagram-tagged-posts-scraper) |
| [Instagram Phone Number Scraper](https://apify.com/scrapier/instagram-phone-number-scraper) |  |

# Actor input Schema

## `urls` (type: `array`):

📋 One list, many names — paste full profile links **or** plain usernames (with or without @).

✨ Examples: `https://www.instagram.com/username/` or just `username`.

🎯 Add more than one to batch your work in a single run.

## `sessionId` (type: `string`):

🍪 This lets the actor act **as you** while you’re logged in — so you only see what your account can normally see.

👉 Copy the `sessionid` cookie from your browser (instagram.com) and paste it here when you start a run.

🤫 Treat it like a password — don’t share it or commit it to code.

## `proxyConfiguration` (type: `object`):

🌐 Sometimes the platform is extra strict — Apify Proxy can help your run stay stable.

✨ You can leave defaults on or tune as you like.

💚 Recommended for larger batches or when you want extra peace of mind.

## Actor input object example

```json
{
  "urls": [
    "https://www.instagram.com/kyliejenner/"
  ],
  "sessionId": "",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://www.instagram.com/kyliejenner/"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapier/instagram-story-details-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://www.instagram.com/kyliejenner/"],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("scrapier/instagram-story-details-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://www.instagram.com/kyliejenner/"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call scrapier/instagram-story-details-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scrapier/instagram-story-details-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Instagram Story Details Scraper",
        "description": "📸 Instagram Story Details Scraper extracts rich Story metadata—timestamps, views, replies, stickers, links, mentions, hashtags, media URLs & user IDs—into clean JSON/CSV. 🚀 Perfect for competitive analysis, campaign tracking, and content strategy. Fast, reliable, API-ready.",
        "version": "0.1",
        "x-build-id": "gwS6e02seRNbDyqri"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scrapier~instagram-story-details-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scrapier-instagram-story-details-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/scrapier~instagram-story-details-scraper/runs": {
            "post": {
                "operationId": "runs-sync-scrapier-instagram-story-details-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/scrapier~instagram-story-details-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-scrapier-instagram-story-details-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "urls",
                    "sessionId"
                ],
                "properties": {
                    "urls": {
                        "title": "🔗👤 Profiles to include",
                        "type": "array",
                        "description": "📋 One list, many names — paste full profile links **or** plain usernames (with or without @).\n\n✨ Examples: `https://www.instagram.com/username/` or just `username`.\n\n🎯 Add more than one to batch your work in a single run.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "sessionId": {
                        "title": "🔑✅ Your Instagram session (required)",
                        "type": "string",
                        "description": "🍪 This lets the actor act **as you** while you’re logged in — so you only see what your account can normally see.\n\n👉 Copy the `sessionid` cookie from your browser (instagram.com) and paste it here when you start a run.\n\n🤫 Treat it like a password — don’t share it or commit it to code.",
                        "default": ""
                    },
                    "proxyConfiguration": {
                        "title": "🛡️🌍 Proxy (optional — smoother runs)",
                        "type": "object",
                        "description": "🌐 Sometimes the platform is extra strict — Apify Proxy can help your run stay stable.\n\n✨ You can leave defaults on or tune as you like.\n\n💚 Recommended for larger batches or when you want extra peace of mind."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```