# Instagram Tagged Posts Scraper⚡ (`premiumscraper/instagram-tagged-posts-scraper`) Actor Extract public Instagram tagged posts and reels with rich details. Get like counts, comment counts, post captions, video durations, location data (names, coordinates, and IDs), tag XY positions, publisher profiles, high-res media URLs, and lists of public comments✨ Instagram Tagged Posts Scraper⚡ - **URL**: https://apify.com/premiumscraper/instagram-tagged-posts-scraper.md - **Developed by:** [Premium Scraper](https://apify.com/premiumscraper) (community) - **Categories:** Automation, Social media, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.80 / 1,000 tagged items This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 Tagged Posts Scraper ⚡ | Premium Public Tagged Posts & Reels Extractor **Instagram Tagged Posts Scraper** is designed specifically to extract public posts and reels where a target Instagram user has been tagged. The **Instagram Tagged Posts Scraper** operates on a resilient, dual-phase pipeline architecture. It enables businesses, research groups, and marketing agencies to harvest valuable user-generated content (UGC), track brand mentions, analyze social sentiment, and monitor influencer activity with absolute precision. With the **Instagram Tagged Posts Scraper**, you can bypass standard API limitations, automatically rotate residential proxies to beat login walls, and fetch fully structured dataset outputs containing detailed engagement stats, media files, and public comments. --- ### 🔄 Instagram Tagged Posts Scraper vs. Competitors | Feature | **Instagram Tagged Posts Scraper** | Traditional Scrapers | | :--- | :--- | :--- | | **Details Enrichment** | ✅ Full enrichment (likes, video urls, comments) | ❌ Incomplete basic metadata | | **Comments Collection** | 💬 Scrapes comments (excluding replies) | ❌ No comment parsing | As seen above, the **Instagram Tagged Posts Scraper** provides unmatched reliability and cost efficiency, ensuring that you only pay for successful results. --- ### 📥 Input Controls for Instagram Tagged Posts Scraper Configuring the **Instagram Tagged Posts Scraper** is simple and highly customizable. It features the following input parameters: * 👤 **Instagram Username(s)** (`username`): Array of target profile usernames (e.g. `nba`, `natgeo`, `cristiano`). The **Instagram Tagged Posts Scraper** will convert these into public profile URLs and target their tagged feeds. * 🔗 **Instagram URLs** (`instagram_urls`): Direct URLs pointing to profile feeds or tagged tabs (e.g., `https://www.instagram.com/nba/tagged/`). * 🎞️/🖼️ **Filter by Type** (`tagged_type_filter`): * `Both (Posts & Reels)`: Collects both standard posts and video reels. * `Posts Only`: Limits collection to image and carousel posts. * `Reels Only`: Restricts collection to clips/video reels. * 🎞️ **Items Per Profile** (`tagged_count`): This parameter determines the maximum items the **Instagram Tagged Posts Scraper** will fetch for each profile before stopping. * 🌐 **Proxy Country** (`proxyCountry`): Residential proxy exit country (default is `US` for broad public availability). * ℹ️ **Get Details** (`get_details`): Enabling this instructs the **Instagram Tagged Posts Scraper** to perform details page queries for each item. This fetches advanced stats (likes, video duration, and detailed user structures). * 💬 **Include Comments** (`include_comments`): This button directs the **Instagram Tagged Posts Scraper** to harvest public comments for each post and reel (replies are excluded to save requests). * 💬 **Comments Limit Per Item** (`comments_limit`): Max comments to return per post/reel (default `20`). --- ### 📤 Output Fields in Instagram Tagged Posts Scraper Every single record outputted by the **Instagram Tagged Posts Scraper** is clean and structured. The **Instagram Tagged Posts Scraper** returns the following data schema: #### 1. Core Metadata Fields * `type` (String): Specifies `"post"` or `"reel"`. This is explicitly placed as the first key at the top of the JSON payload. * `number` (Integer): The sequential index of the item scraped. * `profile_url` (String): The scraped Instagram profile tagged tab URL. * `post_url` (String): Direct URL of the media post (e.g., `https://www.instagram.com/reel/DZp9YgVzuy9/`). * `shortcode` (String): The unique alphanumeric identifier of the post/reel (e.g., `DZp9YgVzuy9`). * `media_id` (String): The raw numeric ID of the post/reel on Instagram. * `post_type` (String): The media sub-type (e.g., `"video"`, `"image"`, or `"carousel"`). * `caption` (String): The caption text. * `caption_data` (Object): Contains raw text, creation timestamp, and creator PK. * `caption_is_edited` (Boolean): Indicates if the caption has been edited. * `taken_at` (Integer): Unix epoch creation timestamp. * `created_at` (String): Human-readable UTC ISO timestamp (e.g., `2026-06-16T17:46:19Z`). * `product_type` (String): Internal classification (e.g., `"clips"`, `"carousel_container"`, or `"feed"`). #### 2. Media Content Fields * `display_url` / `display_uri` (String): URL of the post cover image. * `video_url` (String): Direct video `.mp4` link (if the item is a video or reel). * `video_duration` (Number): Video duration in seconds. * `video_versions` (Array): List of video resolutions. * `original_width` / `original_height` (Integer): Dimensions of the media file. * `is_video` (Boolean): True if the post is a video or reel. #### 3. Engagement Metrics * `like_count` (Integer): Total likes (resolved dynamically from connection nodes). * `comment_count` (Integer): Total comments. * `comments_disabled` (Boolean): True if comments are disabled by the creator. #### 4. Creator Info (`user` / `owner` nodes) Contains profile details of the creator who published the tagged post: * `id` / `pk` (String): Unique user ID. * `username` (String): Creator's handle. * `full_name` (String): Creator's full profile name. * `profile_pic_url` (String): Profile picture link. * `is_verified` (Boolean): True if the user account is verified. * `is_private` (Boolean): True if the user account is private. #### 5. Tagged Locations (`location` node) * `name` (String): Tagged location name. * `pk` (Integer): Location ID. * `lat` / `lng` (Float): Geographical coordinates. #### 6. Tagged User Coordinates (`usertags` node) * `position` (Array): XY coordinates of user tags on the image. * `user` (Object): Username, ID, and profile details of other tagged accounts. #### 7. Scraped Comments List (`comments` / `comment_list` nodes) Scraped comments only work when the tagged post/reel has comments and comment collection is enabled. * `comment_id` (String): Unique ID of the comment. * `text` (String): Plaintext message of the comment. * `created_at` (Integer): Unix creation timestamp of the comment. * `like_count` (Integer): Likes count on the comment. * `user` (Object): Username, PK, and profile picture of the comment author. --- Get started with the **Instagram Tagged Posts Scraper** today to experience the most reliable, clean, and professional tagged media scraping solution on the market! 🚀 # Actor input Schema ## `username` (type: `array`): Enter one or more Instagram usernames such as nba, natgeo, or cristiano. Each username is automatically converted into a tagged URL and scraped. ## `instagram_urls` (type: `array`): Add one or more Instagram profile URLs or tagged tab URLs. Supported formats: • Username: nba • Profile URL: https://www.instagram.com/nba/ • Tagged tab URL: https://www.instagram.com/nba/tagged/ ## `tagged_type_filter` (type: `string`): Select whether to scrape only posts, only reels, or both. ## `tagged_count` (type: `integer`): How many tagged media items to return for each profile input. If fewer tagged items are available, the output clearly shows the requested and returned totals. ## `proxyCountry` (type: `string`): Choose the residential proxy exit country for public Instagram requests. US is recommended for the broadest public coverage. ## `get_details` (type: `boolean`): Turn on to fetch detailed metadata for each tagged post and reel (such as view counts, play counts, video duration, and detailed media metrics) by performing detail page requests. Billing is per detail page scraped. ## `include_comments` (type: `boolean`): Turn on to collect public comments for each returned post/reel. Comments are placed under the comments field. ⚠️ Comment collection adds extra requests per item and can take a significant amount of time. Billing is per returned comment. ## `comments_limit` (type: `integer`): Maximum number of comments to return per post/reel when comment collection is enabled. Higher limits take proportionally longer. ## Actor input object example ```json { "username": [ "cristiano" ], "instagram_urls": [ { "url": "https://www.instagram.com/nba/" } ], "tagged_type_filter": "both", "tagged_count": 10, "proxyCountry": "US", "get_details": false, "include_comments": false, "comments_limit": 20 } ```` # 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 = { "username": [ "cristiano" ], "instagram_urls": [ { "url": "https://www.instagram.com/nba/" } ], "tagged_type_filter": "both", "tagged_count": 10, "proxyCountry": "US", "comments_limit": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("premiumscraper/instagram-tagged-posts-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 = { "username": ["cristiano"], "instagram_urls": [{ "url": "https://www.instagram.com/nba/" }], "tagged_type_filter": "both", "tagged_count": 10, "proxyCountry": "US", "comments_limit": 20, } # Run the Actor and wait for it to finish run = client.actor("premiumscraper/instagram-tagged-posts-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 '{ "username": [ "cristiano" ], "instagram_urls": [ { "url": "https://www.instagram.com/nba/" } ], "tagged_type_filter": "both", "tagged_count": 10, "proxyCountry": "US", "comments_limit": 20 }' | apify call premiumscraper/instagram-tagged-posts-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=premiumscraper/instagram-tagged-posts-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Instagram Tagged Posts Scraper⚡", "description": "Extract public Instagram tagged posts and reels with rich details. Get like counts, comment counts, post captions, video durations, location data (names, coordinates, and IDs), tag XY positions, publisher profiles, high-res media URLs, and lists of public comments✨ Instagram Tagged Posts Scraper⚡", "version": "1.0", "x-build-id": "WfvTrkKkOOf9ePdbd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/premiumscraper~instagram-tagged-posts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-premiumscraper-instagram-tagged-posts-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/premiumscraper~instagram-tagged-posts-scraper/runs": { "post": { "operationId": "runs-sync-premiumscraper-instagram-tagged-posts-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/premiumscraper~instagram-tagged-posts-scraper/run-sync": { "post": { "operationId": "run-sync-premiumscraper-instagram-tagged-posts-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": { "username": { "title": "👤 Instagram Username(s)", "type": "array", "description": "Enter one or more Instagram usernames such as nba, natgeo, or cristiano. Each username is automatically converted into a tagged URL and scraped.", "items": { "type": "string" } }, "instagram_urls": { "title": "🔗 Instagram URLs", "type": "array", "description": "Add one or more Instagram profile URLs or tagged tab URLs. Supported formats:\n• Username: nba\n• Profile URL: https://www.instagram.com/nba/\n• Tagged tab URL: https://www.instagram.com/nba/tagged/\n", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "tagged_type_filter": { "title": "🖼️ Filter by Type", "enum": [ "both", "post", "reel" ], "type": "string", "description": "Select whether to scrape only posts, only reels, or both.", "default": "both" }, "tagged_count": { "title": "🎞️ Items Per Profile", "minimum": 1, "type": "integer", "description": "How many tagged media items to return for each profile input. If fewer tagged items are available, the output clearly shows the requested and returned totals.", "default": 10 }, "proxyCountry": { "title": "🌐 Proxy Country", "enum": [ "US", "GB", "AU", "CA", "DE", "FR", "NL", "IT", "ES", "SE", "NO", "DK", "FI", "BE", "AT", "CH", "IE", "PL", "PT", "CZ", "HU", "RO", "GR", "JP", "KR", "SG", "IN", "BR", "MX", "AR", "TR" ], "type": "string", "description": "Choose the residential proxy exit country for public Instagram requests. US is recommended for the broadest public coverage.", "default": "US" }, "get_details": { "title": "ℹ️ Get Details", "type": "boolean", "description": "Turn on to fetch detailed metadata for each tagged post and reel (such as view counts, play counts, video duration, and detailed media metrics) by performing detail page requests. Billing is per detail page scraped.", "default": false }, "include_comments": { "title": "💬 Include Comments", "type": "boolean", "description": "Turn on to collect public comments for each returned post/reel. Comments are placed under the comments field. ⚠️ Comment collection adds extra requests per item and can take a significant amount of time. Billing is per returned comment.", "default": false }, "comments_limit": { "title": "💬 Comments Limit Per Item", "minimum": 1, "type": "integer", "description": "Maximum number of comments to return per post/reel when comment collection is enabled. Higher limits take proportionally longer.", "default": 20 } } }, "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 } } } } } } } } } } ```