# Instagram Post Detail Scraper (`xtracto/instagram-post-detail-scraper`) Actor Fetch a single Instagram post / reel / IGTV by shortcode or URL. Includes caption, media URLs, engagement, location, taggings. - **URL**: https://apify.com/xtracto/instagram-post-detail-scraper.md - **Developed by:** [Farhan Febrian Nauval](https://apify.com/xtracto) (community) - **Categories:** Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.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. 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 Post Detail Scraper Fetch a single Instagram post, reel, or IGTV by shortcode or URL and get the caption, media URLs, engagement counters, owner, location, and tagged users as one clean JSON record. ### Why use this actor - **No account / no login required** — give it a public Instagram shortcode or URL and you get the data back. - **Accepts shortcodes or URLs** — `DYSM8J5yzSj`, `https://www.instagram.com/p/DYSM8J5yzSj/`, `/reel/...`, and `/tv/...` all work; one dataset row per input. - **All media types** — photo, video, carousel (multi-image / multi-video), and reels are unified into the same output shape. - **Direct media URLs in multiple resolutions** — `image_versions2.candidates` lists every thumbnail size and `video_versions` lists every available bitrate, so you can pick the one you need or mirror them all. - **Owner + tagged users + location** — the full owner profile snippet, tagged accounts (`usertags`), and place data (when the author tagged a location) are included. - **Stable JSON envelope** — every row carries `_input`, `_shortcode`, `_source`, and `_scrapedAt` so you can join results back to your input list and triage failures. ### How it works 1. You provide a list of Instagram post shortcodes or URLs (posts, reels, or IGTV). 2. The actor fetches each post the same way the Instagram web app does and assembles a flat JSON record with caption, media URLs, engagement, and owner. 3. If a post is unavailable on the primary path, the actor automatically falls back to a secondary path before giving up. 4. Results stream into your dataset, ready to download as JSON, CSV, or Excel. You do not need to manage scrapers, browsers, or rotating IPs — all handled internally. ### Input ```json { "posts": [ "DYSM8J5yzSj", "https://www.instagram.com/p/DYSM8J5yzSj/" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["DATACENTER"] } } ```` | Field | Type | Description | |---|---|---| | `posts` | array | List of Instagram post shortcodes or full URLs. Plain shortcodes, `/p/...`, `/reel/...`, and `/tv/...` are all accepted. | | `proxyConfiguration` | object | Apify Proxy settings. Datacenter is the default; switch to Residential for large batches or if you hit rate limits. | ### Output Input: `https://www.instagram.com/p/DYSM8J5yzSj/` ```json { "_input": "https://www.instagram.com/p/DYSM8J5yzSj/", "_shortcode": "DYSM8J5yzSj", "_source": "S1-primary", "_scrapedAt": "2026-05-18T09:14:22.481036+00:00", "code": "DYSM8J5yzSj", "pk": "3896233537988932771", "id": "3896233537988932771_25025320", "taken_at": 1778687953, "media_type": 2, "product_type": "clips", "original_width": 1080, "original_height": 1920, "like_count": 382573, "comment_count": 5950, "view_count": null, "has_audio": true, "is_paid_partnership": false, "comments_disabled": false, "like_and_view_counts_disabled": false, "carousel_media_count": null, "carousel_media": null, "caption": { "text": "48 players. 48 countries. One canvas 🎨⚽\n\n@werner_bronkhorst (Werner Bronkhorst) is an artist known for pairing abstract, textured backgrounds with hyper-realistic miniature figures. His latest piece, ...", "created_at": 1778687952 }, "owner": { "pk": 25025320, "username": "instagram", "full_name": "Instagram", "is_verified": true, "is_private": false, "profile_pic_url": "https://instagram.fcgk52-1.fna.fbcdn.net/v/t51.82787-19/550891366_18667771684001321_1383210656577177067_n.jpg?..." }, "user": { "pk": 25025320, "username": "instagram", "is_verified": true, "is_private": false, "profile_pic_url": "https://instagram.fcgk52-1.fna.fbcdn.net/v/t51.82787-19/550891366_18667771684001321_1383210656577177067_n.jpg?..." }, "usertags": { "in": [ { "user": { "pk": "1993864590", "username": "werner_bronkhorst", "full_name": "Werner Bronkhorst", "is_verified": true, "profile_pic_url": "https://instagram.fcgk52-1.fna.fbcdn.net/v/t51.2885-19/441508531_973274071067668_3812793703924207721_n.jpg?..." }, "position": [0.5, 0.5] } ] }, "location": null, "image_versions2": { "candidates": [ { "url": "https://instagram.fcgk52-1.fna.fbcdn.net/v/t51.82787-15/671776371_18753401356001321_2144846863064822851_n.jpg?...", "width": 1080, "height": 1920 } // ... 12 more candidates at smaller resolutions ] }, "video_versions": [ { "type": 101, "width": 720, "height": 1280, "url": "https://instagram.fcgk52-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQOY5hjf6Sujvcw6V_frgfxGxbJSDQe2owPFdBT19uSi..." } // ... 2 more video renditions ], "clips_metadata": { "audio_type": "original_sounds", "music_info": null, "original_sound_info": { "...": "..." } } } ``` | Field | Type | Description | |---|---|---| | `_input` | string | The shortcode or URL exactly as you supplied it. Use this to join results back to your input list. | | `_shortcode` | string | Normalized shortcode parsed from the input. | | `_source` | string | Internal tag for the path used to fetch the record. `S1-primary` (and `S1-*` variants) means the fastest, richest path; values starting with `S2-`, `S3-`, or `S4-` indicate a fallback was used. | | `_scrapedAt` | string | ISO-8601 UTC timestamp when the record was scraped. | | `code` | string | The Instagram shortcode (same as `_shortcode`). | | `pk` | string | Internal numeric post ID. Stable across URL changes. | | `id` | string | Composite post ID in the form `_`. | | `taken_at` | integer | Unix timestamp (seconds) when the post was published. | | `media_type` | integer | `1` = photo, `2` = video / reel, `8` = carousel. | | `product_type` | string | Sub-type for videos: `clips` (reel), `feed` (in-feed video), `igtv` (long-form), or `null` for photos. | | `original_width` | integer | Native width of the primary media in pixels. | | `original_height` | integer | Native height of the primary media in pixels. | | `like_count` | integer | Total likes at scrape time. | | `comment_count` | integer | Total comments at scrape time. | | `view_count` | integer / null | Video play count when published; `null` for photos or when Instagram hides the counter. | | `has_audio` | boolean | `true` if the video has audio (always `false` for photos). | | `is_paid_partnership` | boolean | `true` if the post is tagged as a paid partnership / branded content. | | `comments_disabled` | boolean | `true` if the author disabled comments on this post. | | `like_and_view_counts_disabled` | boolean | `true` if the author hid like and view counts on this post. | | `carousel_media_count` | integer / null | Number of children in a carousel post; `null` for single-media posts. | | `carousel_media` | array / null | For carousel posts, each child has its own `image_versions2`, `video_versions`, `media_type`, and dimensions in the same shape as the top-level record. `null` for single-media posts. | | `caption.text` | string | The full caption text including emoji, mentions, and hashtags. | | `caption.created_at` | integer | Unix timestamp when the caption was created (usually equal to `taken_at`). | | `owner` | object | Owner profile snippet — `pk`, `username`, `full_name`, `is_verified`, `is_private`, `profile_pic_url`. | | `user` | object | Display-side user snippet for the post (usually identical to `owner`; differs only for some collab posts). | | `usertags.in` | array | List of accounts tagged in the post. Each entry contains a `user` profile snippet and a `position` (`[x, y]`) of the tag on the image. | | `location` | object / null | Place data when the author tagged a location (`pk`, `name`, `short_name`, `lat`, `lng`, `address`, `city`). `null` otherwise. | | `image_versions2.candidates` | array | All available image renditions, sorted largest to smallest. Each entry has `url`, `width`, and `height`. The first entry is the highest-resolution version. | | `video_versions` | array | All available video renditions for video / reel posts. Each entry has `type`, `width`, `height`, and `url`. Sorted highest to lowest quality. | | `clips_metadata` | object / null | Reel-only metadata: `audio_type`, `music_info` (licensed track when applicable), `original_sound_info` (when the audio is original). | #### Error envelope Posts that cannot be fetched return a structured error instead of crashing the run: ```json { "_input": "https://www.instagram.com/p/this-does-not-exist/", "_shortcode": "this-does-not-exist", "_source": "S2-fallback", "_error": "not_found", "_errorDetail": "post page returned 404", "_scrapedAt": "2026-05-18T09:14:24.118201+00:00" } ``` | Error | Meaning | |---|---| | `invalid_input` | The string you passed is not a recognizable Instagram shortcode or URL. | | `not_found` | The post was deleted, never existed, or the account was deactivated. | | `no_anon_data` | All paths returned empty — usually a private account or a region-locked post. | Filter on `_error` to triage failed rows. ### Pricing This actor is billed per result: **$6.00 per 1,000 posts**. Each successful post = 1 result. Errors (`not_found`, `invalid_input`, `no_anon_data`) are not billed. ### Other Sosmed Actors | Platform | Actor | Best for | |---|---|---| | Instagram | [Instagram Account Scraper](https://apify.com/xtracto/instagram-account-scraper) | Bio, followers, post count for any handle | | Instagram | [Instagram Account Posts Scraper](https://apify.com/xtracto/instagram-account-posts-scraper) | Recent posts feed for an account | | Instagram | [Instagram Account Reels Scraper](https://apify.com/xtracto/instagram-account-reels-scraper) | Reels-only feed for an account | | Threads | [Threads Post Detail Scraper](https://apify.com/xtracto/threads-post-detail-scraper) | Single Threads post with replies metadata | | Facebook | [Facebook Post Detail Scraper](https://apify.com/xtracto/facebook-post-detail) | Single Facebook post by URL | | X / Twitter | [X Post Detail Scraper](https://apify.com/xtracto/x-post-detail-scraper) | Single tweet with media and counters | | YouTube | [YouTube Video Detail Scraper](https://apify.com/xtracto/youtube-video-detail-scraper) | Single video with metadata and stats | Browse the full catalog at [apify.com/xtracto](https://apify.com/xtracto). ### Notes - Private posts return only a metadata snippet (and may surface as `_error: "no_anon_data"` when nothing is visible to anonymous viewers). Use a public account or a different post for full detail. - IGTV has been unified with reels since 2025 — `/tv//` URLs work and the record looks the same as a reel (`product_type: "clips"` or `"igtv"`). - Carousel children are returned under `carousel_media` with each child carrying its own `image_versions2`, `video_versions`, and dimensions; the top-level `image_versions2` / `video_versions` for a carousel reflects the cover (first child). - Media CDN URLs (`image_versions2.candidates[].url`, `video_versions[].url`, `profile_pic_url`) are signed and time-bound. Download or mirror them immediately if you need permanence. - For batches over a few hundred posts, switch `proxyConfiguration` to Residential to stay under per-IP rate limits. # Actor input Schema ## `posts` (type: `array`): List of Instagram post shortcodes or full URLs. Accepts plain shortcodes (`DYSM8J5yzSj`), post URLs (`/p/...`), reel URLs (`/reel/...`), and IGTV URLs (`/tv/...`). One dataset row is produced per input. ## `proxyConfiguration` (type: `object`): Apify Proxy settings. Datacenter proxy is the default and works for most posts; switch to Residential for large batches or if you hit rate limits. ## Actor input object example ```json { "posts": [ "DYSM8J5yzSj", "https://www.instagram.com/p/DYP-BHSPCfn/" ], "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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "posts": [ "DYSM8J5yzSj", "https://www.instagram.com/p/DYP-BHSPCfn/" ] }; // Run the Actor and wait for it to finish const run = await client.actor("xtracto/instagram-post-detail-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 = { "posts": [ "DYSM8J5yzSj", "https://www.instagram.com/p/DYP-BHSPCfn/", ] } # Run the Actor and wait for it to finish run = client.actor("xtracto/instagram-post-detail-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 '{ "posts": [ "DYSM8J5yzSj", "https://www.instagram.com/p/DYP-BHSPCfn/" ] }' | apify call xtracto/instagram-post-detail-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=xtracto/instagram-post-detail-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Instagram Post Detail Scraper", "description": "Fetch a single Instagram post / reel / IGTV by shortcode or URL. Includes caption, media URLs, engagement, location, taggings.", "version": "1.0", "x-build-id": "dBmRhaZP4gPkTVALb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xtracto~instagram-post-detail-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xtracto-instagram-post-detail-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/xtracto~instagram-post-detail-scraper/runs": { "post": { "operationId": "runs-sync-xtracto-instagram-post-detail-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/xtracto~instagram-post-detail-scraper/run-sync": { "post": { "operationId": "run-sync-xtracto-instagram-post-detail-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": [ "posts" ], "properties": { "posts": { "title": "Instagram post shortcodes or URLs", "type": "array", "description": "List of Instagram post shortcodes or full URLs. Accepts plain shortcodes (`DYSM8J5yzSj`), post URLs (`/p/...`), reel URLs (`/reel/...`), and IGTV URLs (`/tv/...`). One dataset row is produced per input.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy settings. Datacenter proxy is the default and works for most posts; switch to Residential for large batches or if you hit rate limits.", "default": { "useApifyProxy": 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 } } } } } } } } } } ```