# Instagram Scraper (`hpix/instagram-scraper`) Actor Scrape Instagram profiles, posts, and Reels at scale. - **URL**: https://apify.com/hpix/instagram-scraper.md - **Developed by:** [Hpix](https://apify.com/hpix) (community) - **Categories:** Social media, Lead generation - **Stats:** 97 total users, 21 monthly users, 84.5% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $0.65 / 1,000 profile posts This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 Scraper **The Ultimate All-in-One Instagram Scraper** Extract high-quality data from Instagram profiles, posts, and Reels in seconds. Designed for marketers, researchers, and creators who need reliable data without the technical headache. ### 🚀 Why choose this Scraper? - **Reliability by Default:** No more worrying about getting blocked. This Actor uses premium residential proxies and anti-detection mechanisms to ensure your tasks finish successfully. - **Reels, Posts & Profiles:** Whether you need engagement stats on a viral Reel or the follower count of a specific influencer, we've got you covered. - **Clear, Predictable Costs:** Stop guessing how much memory or CPU you need. You only pay for the data you actually receive. - **Beautiful Data Views:** Don't get lost in code. Use the built-in output tabs to see your results in a clean, organized table with images. ### **✨ What can you do with it?** - **Analyze Engagement:** Get play counts, likes, and comment totals for Reels and Posts. - **Monitor Influencers:** Track bio changes, follower growth, and verified status. - **Content Research:** Use the **Date Filter** to only see content from the last week or month. - **Bulk Exports:** Download your results instantly as **Excel, CSV, or JSON**. ### **🛠️ Getting Started is Easy** 1. **Enter URLs or Usernames:** Paste the Instagram profiles or specific post links you want to scrape. 2. **Pick Your Content:** Toggle profile data, posts, and reels independently — or scrape them all at once. 3. **Set Your Limits:** Use the "Posts per account" or "Date Range" filters to get exactly what you need. 4. **Run & Relax:** Click **Start** and watch your data populate in the "Output" tab. ### **📊 Sample Output** #### Profile Data | Username | Full name | Profile picture | Followers | Following | Data | | -------- | --------------- | ------------------------ | ---------- | --------- | --------------- | | zuck | Mark Zuckerberg | | 16,879,414 | 623 | | #### Post Data | Thumbnail | Caption | Code | Type | Like count | Comment count | Data | | ---------------- | ------------------------------------- | ----------- | ---- | ---------- | ------------- | --------------- | | | Two decades, many awesome projects... | DTTbdGlkaWl | post | 158,039 | 5,228 | | #### Reel Data | Thumbnail | Caption | Play count | Comment count | Like count | Data | | ---------------- | ------------------------------------- | ---------- | ------------- | ---------- | --------------- | | | When @merab.dvalishvili is in town... | 27,979,151 | 4,670 | 394,756 | | ### **💡 Pro Tips** - **Massive Lists:** This Actor is optimized for bulk. You can input hundreds of profiles at once; it will handle the queue automatically. - **Date Filtering:** To save time and budget, use the beginDate parameter to only grab content created recently (e.g., "7 days ago"). - **Custom Logic:** Advanced users can use the "Custom functions" field to automatically skip posts that don't meet specific criteria (like posts without music). - **Cleaner Output:** Disable the "Include raw data" option to strip the raw Instagram API response from the output and reduce dataset size. - **Pin Skipping:** "Skip pinned posts" and "Skip pinned reels" let you skip content pinned to specific tabs independently — useful for accounts that pin promotional content to the top of their feed. ### 🔧 Advanced Usage #### Custom functions This is an advanced parameter that you can use to modify the crawler's behavior. With custom functions, you can skip a post or profile based on its data or stop crawling a profile's posts when a certain condition is met. Two hooks are available: - **`shouldSkip(item)`** — Return `true` to skip the current item (post, reel, or profile). Processing continues with the next item. - **`shouldContinue(item)`** — Return `false` to stop crawling after the current item. Useful for stopping at a specific post. For example, skip posts that don't have music metadata: ```javascript { shouldSkip: (item) => item.kind == "post" && !item.data.music_metadata; } ```` Or stop crawling when it reaches a specific post code: ```javascript { shouldContinue: (item) => item.data.code != "codeToStopCrawling"; } ``` You can see the item schema by selecting "All fields" on the output tab, and viewing as JSON. #### Restricted Posts Some Instagram posts are age-restricted or otherwise limited and can't be accessed through the standard API. Enable the **"Scrape restricted posts"** toggle to attempt fetching these individual posts. This is a paid feature — each restricted post scraped incurs an additional charge on top of the standard per-post fee. Please refer to the Actor pricing for details. ### 📃 Changelog Do you have a feature suggestion? Create an [issue](https://console.apify.com/actors/JER1eC8E7teQWMN3p/issues) and let me know! #### v1.1.0 - ✨ Added restricted posts scraping - ✨ Added skip\_pinned\_timeline and skip\_pinned\_reels options (deprecated skip\_pinned) - 🔧 Improved output schema and dataset views - 🔧 Fixed date range filtering for pinned posts - Initial release ### ❓ FAQ #### Can I export the scraped data to Excel? Sure! Apify allows you to download the results as an Excel spreadsheet. You can also download in CSV, JSON, XML, HTML, JSONL, and RSS. #### What other data is available apart from the examples shown? Each post, reel, and profile contains a `data` field with extensive metadata beyond what's shown in the table view. To explore all available fields, select "All fields" in the output tab and view the results as JSON. Here are some notable fields available in the output: | Field | Type | Description | | ---------------- | -------- | ------------------------------------------------------------------- | | `is_pinned` | boolean | Whether the post/reel is pinned by the profile | | `pinned_tabs` | string\[] | Tabs where the item is pinned: `["timeline"]`, `["reels"]`, or both | | `music_info` | object | Music metadata for reels (artist, song title, album art) | | `video_versions` | array | All available video resolution URLs for reels | | `hashtags` | string\[] | Hashtags extracted from the caption | | `video_duration` | number | Video duration in seconds (for video posts and reels) | | `view_count` | number | View count for individual reels (when scraping by post URL) | | `bio_links` | string | External URL from the profile's bio | #### I just found a bug! Can you fix it? Oh, what a shame! Please create an [Issue](https://console.apify.com/actors/JER1eC8E7teQWMN3p/issues), so I can evaluate what happened. #### Can you implement X feature? Of course! You can use the **[Issues](https://console.apify.com/actors/JER1eC8E7teQWMN3p/issues)** tab to suggest new features. ### ⚠️ Disclaimer This Actor scrapes public data from Instagram pages. Features are susceptible to changes made by Meta. ### ⛓️‍💥 Known issues - Private or age-restricted accounts cannot be scraped as they are not publicly accessible. - View counts for Reels are only available when scraping individual post URLs, not when scraping entire profiles. Play counts, however, are available in both scenarios. - Instagram does not provide view counts for some posts, as these metrics are not publicly visible for those specific posts. ### 👀 See also - [Instagram Profile Monitor](https://apify.com/hpix/instagram-profile-monitor): Track Instagram profiles over time and monitor growth trends with historical data analysis and beautiful visualizations. Perfect for tracking competitors, influencers, or your own profile's performance. # Actor input Schema ## `profiles` (type: `array`): Instagram usernames or URLs ## `scrape_posts` (type: `boolean`): Scrape all posts (images and reels) from profiles. ## `scrape_reels` (type: `boolean`): Scrape reels from profiles. To scrape metadata like play count and music info, disable the "Scrape posts" option above. ## `scrape_profile_data` (type: `boolean`): Scrape profile information ## `posts_per_account` (type: `integer`): Number of posts/reels to fetch per user ## `skip_pinned_timeline` (type: `boolean`): Skips posts pinned on the timeline view (first tab) of a profile ## `skip_pinned_reels` (type: `boolean`): Skips reels pinned on the reels view (second tab) of a profile ## `posts` (type: `array`): Scrape posts using their URL or code ## `scrape_restricted_posts` (type: `boolean`): Scrape age-restricted or otherwise limited Instagram posts that are not publicly available by default. This is a paid feature — please refer to the Actor pricing. ## `fromDate` (type: `string`): Start scraping from this date (oldest posts to include) ## `toDate` (type: `string`): Stop scraping at this date (newest posts to include) ## `custom_functions` (type: `string`): Functions to customize the crawler's behaviour. Accepts an object with two functions, `shouldSkip` and `shouldContinue`, each taking a data argument which contains the data for the current scraped item. ## `include_raw_data` (type: `boolean`): Include the `data` field in the output. Disabling this decreases the size of the output dataset. ## Actor input object example ```json { "profiles": [ "zuck" ], "scrape_posts": true, "scrape_reels": true, "scrape_profile_data": true, "posts_per_account": 12, "skip_pinned_timeline": false, "skip_pinned_reels": false, "scrape_restricted_posts": false, "custom_functions": "{ shouldSkip: (item) => item.kind == 'post' && !item.data.music_metadata, shouldContinue: (item) => item.data.code != 'codeToStopCrawling' }", "include_raw_data": true } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "profiles": [ "zuck" ], "custom_functions": "{ shouldSkip: (item) => false, shouldContinue: (item) => true }" }; // Run the Actor and wait for it to finish const run = await client.actor("hpix/instagram-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "profiles": ["zuck"], "custom_functions": "{ shouldSkip: (item) => false, shouldContinue: (item) => true }", } # Run the Actor and wait for it to finish run = client.actor("hpix/instagram-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 '{ "profiles": [ "zuck" ], "custom_functions": "{ shouldSkip: (item) => false, shouldContinue: (item) => true }" }' | apify call hpix/instagram-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=hpix/instagram-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Instagram Scraper", "description": "Scrape Instagram profiles, posts, and Reels at scale.", "version": "1.1", "x-build-id": "GCuiK7HHUiMd8RBaC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hpix~instagram-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hpix-instagram-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/hpix~instagram-scraper/runs": { "post": { "operationId": "runs-sync-hpix-instagram-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/hpix~instagram-scraper/run-sync": { "post": { "operationId": "run-sync-hpix-instagram-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", "properties": { "profiles": { "title": "Profiles", "minItems": 0, "type": "array", "description": "Instagram usernames or URLs", "items": { "type": "string" } }, "scrape_posts": { "title": "Scrape posts", "type": "boolean", "description": "Scrape all posts (images and reels) from profiles.", "default": true }, "scrape_reels": { "title": "Scrape reels", "type": "boolean", "description": "Scrape reels from profiles. To scrape metadata like play count and music info, disable the \"Scrape posts\" option above.", "default": true }, "scrape_profile_data": { "title": "Scrape profile data", "type": "boolean", "description": "Scrape profile information", "default": true }, "posts_per_account": { "title": "Posts per account", "type": "integer", "description": "Number of posts/reels to fetch per user", "default": 12 }, "skip_pinned_timeline": { "title": "Skip pinned posts", "type": "boolean", "description": "Skips posts pinned on the timeline view (first tab) of a profile", "default": false }, "skip_pinned_reels": { "title": "Skip pinned reels", "type": "boolean", "description": "Skips reels pinned on the reels view (second tab) of a profile", "default": false }, "posts": { "title": "Individual Posts", "type": "array", "description": "Scrape posts using their URL or code", "items": { "type": "string" } }, "scrape_restricted_posts": { "title": "[$] Scrape restricted posts", "type": "boolean", "description": "Scrape age-restricted or otherwise limited Instagram posts that are not publicly available by default. This is a paid feature — please refer to the Actor pricing.", "default": false }, "fromDate": { "title": "From date (oldest)", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$", "type": "string", "description": "Start scraping from this date (oldest posts to include)" }, "toDate": { "title": "To date (newest)", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$", "type": "string", "description": "Stop scraping at this date (newest posts to include)" }, "custom_functions": { "title": "Custom functions", "type": "string", "description": "Functions to customize the crawler's behaviour. Accepts an object with two functions, `shouldSkip` and `shouldContinue`, each taking a data argument which contains the data for the current scraped item." }, "include_raw_data": { "title": "Include raw data", "type": "boolean", "description": "Include the `data` field in the output. Disabling this decreases the size of the output dataset.", "default": true } } }, "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 } } } } } } } } } } ```