# ✅ Instagram User Highlights Scraper (`datamagnet/instagram-user-highlights-scraper`) Actor Fetch the Highlights tray from public Instagram profiles by username, user ID, or profile URL. Get the raw highlight data exactly as returned, and check one or more profiles in a single run for fast Instagram profile research. - **URL**: https://apify.com/datamagnet/instagram-user-highlights-scraper.md - **Developed by:** [Datamagnet](https://apify.com/datamagnet) (community) - **Categories:** Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Highlights Tray Scraper Instagram Highlights Tray Scraper helps you quickly fetch the Highlights tray from a public Instagram profile so you can see what highlight collections are available at a glance. It is built for marketers, researchers, creators, agencies, and anyone who needs Instagram profile data without digging through the app manually. You can look up a profile by username, user ID, or profile URL, and check one or more profiles in a single run. The actor returns the raw highlight data exactly as provided, making it easy to review highlight titles, cover images, media counts, and profile details. ### Key Features - Extract the Highlights tray for any public Instagram profile you specify. - Collect profile data by username, user ID, or profile URL for flexible lookups. - Review highlight titles, cover images, and media counts in one place. - Compare multiple profiles in a single run to save time. - Preserve the source data exactly as returned for accurate review and downstream use. - Identify profile details such as verified status, privacy status, and display name. - Support faster research workflows for social media analysis, brand checks, and content audits. ### Use Cases #### Social Media Research Social media analysts use this actor to quickly inspect the Highlights tray of public Instagram accounts. The returned fields such as `title`, `media_count`, `created_at`, and `updated_timestamp` help them understand what content a profile chooses to feature and how active those highlights are. #### Brand and Competitor Review Marketing teams can compare how brands organize their Instagram Highlights across multiple profiles. By reviewing `cover_media`, `title`, `is_pinned_highlight`, and `user.full_name`, they can spot patterns in branding, content themes, and profile presentation. #### Influencer Vetting Agencies and sponsorship teams often need a fast way to evaluate creator profiles before outreach. This actor provides `user.is_verified`, `user.is_private`, `user.username`, and highlight metadata so teams can confirm whether a profile looks active, public, and professionally maintained. #### Content Planning Creators and social media managers can use the output to study how successful accounts structure their Highlights. Fields like `title`, `media_count`, and `latest_reel_media` help them decide which content categories deserve a permanent place on their own profile. #### Lead Qualification Sales and partnership teams can use public Instagram profile data to understand whether an account is worth a closer look. The highlight tray, combined with profile details such as `user.id`, `user.full_name`, and `user.profile_pic_url`, gives a quick snapshot that supports faster qualification. #### Profile Audits Agencies managing multiple accounts can audit highlight organization across clients or internal brand pages. The actor makes it easy to review whether highlights are archived, pinned, converted to clips, or simply part of the default tray, helping teams keep profiles consistent. ### Input | Field | Type | Required | Description | Example | |---|---|---:|---|---| | username_or_id_or_url | string | Yes | Enter one or more public Instagram usernames, user IDs, or profile URLs to fetch their Highlights tray. | mrbeast | ### Output | Field | Type | Description | |---|---|---| | can_gif_quick_reply | boolean | Shows whether the highlight can support quick GIF-style replies. Useful as a sign of available interaction options. | | can_react_with_avatar | boolean | Indicates whether avatar reactions are available for the highlight. | | can_reply | boolean | Tells you if replies are allowed for this highlight. | | can_reshare | boolean | Shows whether the highlight can be reshared. | | contains_stitched_media_blocked_by_rm | boolean | Indicates whether the highlight includes stitched media that is restricted. | | cover_media | object | Contains the highlight cover image details, including cropped and full image versions. | | created_at | number | The time the highlight was created, shown as a timestamp. | | highlight_pog_unseen | null | A status field that may be empty when no unseen highlight state is available. | | highlight_reel_type | string | Describes the type of highlight reel. | | id | string | The unique identifier for the highlight. | | is_archived | boolean | Shows whether the highlight is archived. | | is_converted_to_clips | boolean | Indicates whether the highlight was converted into clips. | | is_nux | boolean | Indicates whether this is a new-user or onboarding-style highlight state. | | is_pinned_highlight | boolean | Shows whether the highlight is pinned to the profile. | | latest_reel_media | number | The most recent media timestamp included in the highlight. | | media_count | number | The number of items inside the highlight. | | prefetch_count | number | A count related to preloaded content for the highlight. | | ranked_position | number | The highlight’s ordering position in the tray. | | reel_type | string | The general reel category for the returned item. | | seen_ranked_position | number | The highlight’s ordering position after being seen. | | title | string | The highlight name shown on the profile. | | updated_timestamp | number | The last time the highlight was updated, shown as a timestamp. | | user | object | Contains the public profile details for the account that owns the highlight. | | user.account_badges | array | Any badges attached to the profile. | | user.fifa_country_code | string | Country code associated with the profile. | | user.full_name | string | The display name of the Instagram account. | | user.id | string | The unique user ID for the profile. | | user.interop_messaging_user_fbid | string | A messaging-related identifier tied to the profile. | | user.is_creator_agent_enabled | boolean | Indicates whether creator agent features are enabled. | | user.is_private | boolean | Shows whether the profile is private. | | user.is_verified | boolean | Shows whether the profile is verified. | | user.profile_pic_id | string | The identifier for the profile picture. | | user.profile_pic_url | string | The profile picture link. | | user.username | string | The Instagram username for the profile. | | cover_media.crop_rect | array | The crop area used for the cover image. | | cover_media.cropped_image_version.height | number | The height of the cropped cover image. | | cover_media.cropped_image_version.url | string | The link to the cropped cover image. | | cover_media.cropped_image_version.width | number | The width of the cropped cover image. | | cover_media.full_image_version.height | number | The height of the full cover image. | | cover_media.full_image_version.url | string | The link to the full-size cover image. | | cover_media.full_image_version.width | number | The width of the full cover image. | | cover_media.id | string | The unique identifier for the cover media. | | cover_media.upload_id | null | An upload-related identifier that may be empty. | ### Sample Output ```json { "can_gif_quick_reply": true, "can_react_with_avatar": false, "can_reply": true, "can_reshare": true, "contains_stitched_media_blocked_by_rm": false, "cover_media": { "crop_rect": [ 0, 0.21875, 1, 0.78125 ], "cropped_image_version": { "height": 150, "url": "https://scontent-phx1-1.cdninstagram.com/v/t51.82787-15/555003756_18043662608392639_57526329583388619_n.jpg?stp=c0.455.1170.1170a_dst-jpg_e35_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6Ij8ueHBpZHMuMTE3MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=8a8i5FCOl-8Q7kNvwHibA3Z&_nc_oc=AdpOCLCrM7GkPkAmXl4a21dbFQvtomR21JJMT3PM5521c7GYdnpnvAT8IcsKR7S4Ae8&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-phx1-1.cdninstagram.com&_nc_gid=Ecfwz11N3GUvBnt8i2iKIQ&_nc_ss=703ba&oh=00_AQCQB6_D3GpsXPNeM0Zu4KxPGM7jizCTWFKhlpb6B43seA&oe=6A5A5517", "width": 150 }, "full_image_version": { "height": 1137, "url": "https://scontent-phx1-1.cdninstagram.com/v/t51.82787-15/555003756_18043662608392639_57526329583388619_n.jpg?stp=dst-jpg_e35_p640x640_sh2.08_tt6&_nc_cat=1&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6Ij8ueHBpZHMuMTE3MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=8a8i5FCOl-8Q7kNvwHibA3Z&_nc_oc=AdpOCLCrM7GkPkAmXl4a21dbFQvtomR21JJMT3PM5521c7GYdnpnvAT8IcsKR7S4Ae8&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-phx1-1.cdninstagram.com&_nc_gid=Ecfwz11N3GUvBnt8i2iKIQ&_nc_ss=703ba&oh=00_AQCLBFHgFRFlwa38MeNX8anJKd3Mk8xAvbyqPoI95bcWEA&oe=6A5A5517", "width": 640 }, "id": "2719200566406473491", "upload_id": null }, "created_at": 1638393333, "highlight_pog_unseen": null, "highlight_reel_type": "DEFAULT", "id": "highlight:17929440964811872", "is_archived": false, "is_converted_to_clips": false, "is_nux": false, "is_pinned_highlight": false, "latest_reel_media": 1754706822, "media_count": 14, "prefetch_count": 0, "ranked_position": -1754706856, "reel_type": "highlight_reel", "seen_ranked_position": -1754706856, "title": "Operation Chad", "updated_timestamp": 1754706856, "user": { "account_badges": [], "fifa_country_code": "US", "full_name": "MrBeast", "id": "2278169415", "interop_messaging_user_fbid": "116505369742833", "is_creator_agent_enabled": false, "is_private": false, "is_verified": true, "profile_pic_id": "1765328607101572916", "profile_pic_url": "https://scontent-phx1-1.cdninstagram.com/v/t51.2885-19/31077884_211593632905749_1394765701385814016_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby41MDAuYzIifQ&_nc_ht=scontent-phx1-1.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2gFFdxgs6Cwl-xWdnannX4tIjplPDZ6yS5BuIqPbADSs6-33zv4bPnfAed-iJ63nhvM&_nc_ohc=u-d-0zAsjvAQ7kNvwEunGYs&_nc_gid=Ecfwz11N3GUvBnt8i2iKIQ&edm=APs17CUBAAAA&ccb=7-5&ig_cache_key=GPw12gEVelN7ccAAAAAAAAAENFsTbkULAAAB1501500j-ccb7-5&oh=00_AQAOlmeJT7IZEyoeEWyF4Q156imx3KaL3_5tyWipfbAVTg&oe=6A5A498F&_nc_sid=10d13b", "username": "mrbeast" } } ```` ### How It Works 1. You enter one or more public Instagram usernames, user IDs, or profile URLs. 2. The actor looks up each profile and fetches its Highlights tray automatically. 3. It gathers the highlight details exactly as returned, including titles, cover images, and profile information. 4. If you provide multiple profiles, it processes them one by one in the same run. 5. Your results are ready to review, download, or use in your own workflow. ### Getting Started Getting started is simple and does not require coding knowledge. Click **Try for free**, paste in a username, user ID, or profile URL, and click **Run**. In a short time, you will receive the Highlights tray data for the profile you entered. You can then export the results as JSON, CSV, or Excel depending on how you want to review or share the data. ### Frequently Asked Questions #### Do I need technical skills? No. This actor is designed for non-technical users who want quick access to Instagram Highlights tray data. You only need to enter a username, user ID, or profile URL and run it. #### How fast does it run? It is built for fast profile lookups, and most runs finish quickly depending on how many profiles you enter. If you check several profiles in one run, it may take a little longer than a single lookup. #### What format is the output? The results are available in easy-to-use formats such as JSON, CSV, or Excel. That makes it simple to review the data yourself or share it with teammates. #### Is this legal to use? This actor is intended for public Instagram profiles only. You should always make sure your use complies with applicable laws, Instagram’s terms, and your own internal policies. #### Can I schedule it to run automatically? Yes, you can set it up to run on a schedule if you want regular checks of public profiles. This is useful for ongoing research, monitoring profile changes, or keeping track of highlight updates over time. # Actor input Schema ## `username_or_id_or_url` (type: `string`): Enter a public Instagram username, user ID, or profile URL to fetch the Highlights tray. ## Actor input object example ```json { "username_or_id_or_url": "mrbeast" } ``` # 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_or_id_or_url": "mrbeast" }; // Run the Actor and wait for it to finish const run = await client.actor("datamagnet/instagram-user-highlights-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_or_id_or_url": "mrbeast" } # Run the Actor and wait for it to finish run = client.actor("datamagnet/instagram-user-highlights-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_or_id_or_url": "mrbeast" }' | apify call datamagnet/instagram-user-highlights-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=datamagnet/instagram-user-highlights-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "✅ Instagram User Highlights Scraper", "description": "Fetch the Highlights tray from public Instagram profiles by username, user ID, or profile URL. Get the raw highlight data exactly as returned, and check one or more profiles in a single run for fast Instagram profile research.", "version": "0.0", "x-build-id": "K0oaTfhxypwLx7Dvn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datamagnet~instagram-user-highlights-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datamagnet-instagram-user-highlights-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/datamagnet~instagram-user-highlights-scraper/runs": { "post": { "operationId": "runs-sync-datamagnet-instagram-user-highlights-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/datamagnet~instagram-user-highlights-scraper/run-sync": { "post": { "operationId": "run-sync-datamagnet-instagram-user-highlights-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": [ "username_or_id_or_url" ], "properties": { "username_or_id_or_url": { "title": "Instagram username, user ID, or profile URL", "type": "string", "description": "Enter a public Instagram username, user ID, or profile URL to fetch the Highlights tray." } } }, "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 } } } } } } } } } } ```