# Instagram Hashtag Posts Scraper (`breathtaking_anthem/instagram-hashtag-posts-scraper`) Actor Extract posts, reels, and media data from any public Instagram hashtag. Get engagement metrics, captions, trending audio, author profiles, and location data in clean JSON — no cookies or login needed. - **URL**: https://apify.com/breathtaking\_anthem/instagram-hashtag-posts-scraper.md - **Developed by:** [PinaCode](https://apify.com/breathtaking_anthem) (community) - **Categories:** Lead generation, Social media - **Stats:** 8 total users, 7 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.40 / 1,000 per post scrapeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 Hashtag Posts Scraper > **Extract Instagram posts, reels, and media data from any hashtag — no login, no cookies, no limits.** > Get likes, comments, play counts, captions, audio, location, author info, and more in clean structured JSON. --- ### 🌟 Why This Scraper? Whether you're tracking trends, doing influencer research, or building a content intelligence pipeline — this scraper gives you **deep, structured data** from Instagram hashtag feeds at scale. - ✅ No Instagram login or session cookies required - ✅ Scrape **Recent** (latest) or **Top** (highest-performing) posts - ✅ Full media metadata: photos, videos, reels, and carousels - ✅ Rich engagement metrics: likes, comments, plays, shares - ✅ Audio intelligence: track trending sounds and licensed music - ✅ Author profiling: follower count, account type, verification status - ✅ Location data: city, coordinates, venue name - ✅ Pagination cursor support — resume interrupted runs *(paid users)* - ✅ Auto-retry on failures — up to 3 retries per request --- ### 🚀 Quick Start 1. Enter a **hashtag** (without `#`) — e.g. `travel`, `fitness`, `streetphotography` 2. Choose a **scrape type**: `Recent` for the latest posts or `Top` for viral content 3. Set your **max items** limit 4. Hit **Start** — results land in your dataset in seconds --- ### 📥 Input Parameters | Parameter | Type | Required | Default | Description | |---------------|---------|----------|----------|-------------| | `hashtag` | String | ✅ Yes | — | Hashtag to scrape (without `#`). Example: `travel`, `fitness`, `reelsinstagram` | | `scrape_type` | String | ❌ No | `recent` | Feed to scrape: `recent` (latest posts) or `top` (best performing) | | `max_items` | Integer | ❌ No | `24` | Maximum number of posts/reels to return. Minimum: `24` | | `cursor` | String | ❌ No | — | Pagination cursor from a previous run to resume scraping | #### 📋 Example Input ```json { "hashtag": "streetphotography", "scrape_type": "top", "max_items": 100 } ```` *** ### 📤 Output Data Each item represents one Instagram post, reel, or carousel with full metadata. #### 🔑 Identity Fields | Field | Type | Description | |---------------------|----------|-------------| | `id` | String | Instagram internal post ID (`pk`) | | `shortcode` | String | Post shortcode (used in URL) | | `url` | String | Direct link to the post or reel | | `taken_at` | Integer | Unix timestamp of when the post was published | | `taken_at_timestamp`| String | ISO 8601 formatted publish datetime (UTC) | | `scraped_at` | String | ISO 8601 datetime when this item was scraped | | `product_type` | String | `clips` for Reels, `feed` for regular posts | | `media_type` | Integer | `1` = Photo, `2` = Video, `8` = Carousel | #### 👤 Author Fields (`author` object) | Field | Type | Description | |------------------|---------|-------------| | `id` | String | Author's Instagram user ID | | `username` | String | Instagram handle | | `full_name` | String | Display name | | `is_verified` | Boolean | Blue checkmark verification status | | `is_private` | Boolean | Whether the account is private | | `follower_count` | Integer | Number of followers at time of scrape | | `account_type` | Integer | `1` = Personal, `2` = Creator, `3` = Business | | `profile_pic_url`| String | Profile picture URL | #### 📝 Content Fields | Field | Type | Description | |------------------------|---------|-------------| | `caption` | String | Full post caption text | | `hashtags` | Array | List of hashtags extracted from caption | | `mentions` | Array | List of @mentioned usernames in caption | | `caption_is_edited` | Boolean | Whether the caption was edited after posting | | `carousel_media_count` | Integer | Number of slides (carousel posts only) | #### 📊 Engagement Metrics | Field | Type | Description | |-------------------------------|---------|-------------| | `like_count` | Integer | Instagram likes | | `comment_count` | Integer | Instagram comments | | `play_count` | Integer | Video/reel play count | | `ig_play_count` | Integer | Instagram-specific play count | | `fb_play_count` | Integer | Facebook play count (cross-posted) | | `fb_like_count` | Integer | Facebook likes | | `fb_comment_count` | Integer | Facebook comments | | `reshare_count` | Integer | Number of reshares | | `like_and_view_counts_disabled` | Boolean | Whether counts are hidden by the creator | #### 🎬 Media Fields | Field | Type | Description | |--------------------|--------|-------------| | `video_url` | String | Direct URL to the highest-quality video | | `thumbnail_url` | String | URL to the post thumbnail image | | `duration_seconds` | Float | Video/reel duration in seconds | | `original_width` | Integer| Original media width (pixels) | | `original_height` | Integer| Original media height (pixels) | | `has_audio` | Boolean| Whether the media includes audio | #### 🎵 Audio Fields (`audio` object) Handles all 3 Instagram audio structures: licensed music, original sounds, and audio type flags. | Field | Type | Description | |------------------------|---------|-------------| | `title` | String | Song/track title (licensed music) | | `artist` | String | Artist name or original audio creator | | `type` | String | `licensed_music`, `original_sound`, or audio type flag | | `is_explicit` | Boolean | Explicit content flag | | `original_audio_title` | String | Custom title for original audio | | `is_trending` | Boolean | Whether the audio is trending in Reels | #### 📍 Location Fields (`location` object) | Field | Type | Description | |-----------|--------|-------------| | `pk` | String | Location ID | | `name` | String | Venue or place name | | `address` | String | Street address | | `city` | String | City name | | `lat` | Float | Latitude coordinate | | `lng` | Float | Longitude coordinate | #### 🤝 Collaboration & Rights Fields | Field | Type | Description | |-----------------------------|---------|-------------| | `is_paid_partnership` | Boolean | Whether the post is a sponsored/paid partnership | | `coauthor_usernames` | Array | List of co-author Instagram handles | | `has_tagged_users` | Boolean | Whether users are tagged in the post | | `can_viewer_reshare` | Boolean | Whether resharing is allowed | | `ig_media_sharing_disabled` | Boolean | Whether media sharing is disabled | *** #### 📦 Example Output Item ```json { "id": "3621480123456789012", "shortcode": "DAbc1234XYZ", "url": "https://www.instagram.com/reel/DAbc1234XYZ/", "taken_at": 1720000000, "taken_at_timestamp": "2024-07-03T12:00:00+00:00", "scraped_at": "2025-04-13T09:30:00+00:00", "product_type": "clips", "media_type": 2, "author": { "id": "123456789", "username": "jane.travels", "full_name": "Jane Wanderlust", "is_verified": false, "is_private": false, "follower_count": 48200, "account_type": 2, "profile_pic_url": "https://..." }, "caption": "Golden hour in Santorini 🌅 #travel #greece #sunset #reels", "hashtags": ["travel", "greece", "sunset", "reels"], "mentions": [], "like_count": 4821, "comment_count": 112, "play_count": 98400, "video_url": "https://...", "thumbnail_url": "https://...", "duration_seconds": 14.5, "has_audio": true, "audio": { "title": "Golden Hour", "artist": "JVKE", "type": "licensed_music", "is_explicit": false, "original_audio_title": null, "is_trending": true }, "location": { "pk": "213204004", "name": "Santorini, Greece", "city": "Santorini", "lat": 36.3932, "lng": 25.4615 }, "is_paid_partnership": false, "coauthor_usernames": [], "has_tagged_users": true } ``` *** #### 🔖 Final Cursor Record *(paid users only)* The last item in the dataset contains pagination metadata for resuming future runs: ```json { "_metadata": { "cursor": "QVFDZjJmUTdQcGQ4VUluUFZMa3N...", "total_scraped": 500, "unique_items": 498, "hashtag": "travel" } } ``` *** ### 🔁 Resuming a Scrape Paid users can continue any scrape from where it left off: 1. Copy the `cursor` value from the `_metadata` record in your dataset 2. Start a new run with the same hashtag 3. Paste the cursor into the **Resume Cursor** field 4. The scraper picks up exactly where you left off — no duplicate data *** ### 💳 Free vs Paid | Feature | Free | Paid | |-------------------------------|-----------|---------------| | Posts per run | ~24 | Up to `max_items` | | Scrape type | ✅ Both | ✅ Both | | Full output fields | ✅ Yes | ✅ Yes | | Pagination cursor returned | ❌ No | ✅ Yes | | Resume interrupted runs | ❌ No | ✅ Yes | | Priority support | ❌ No | ✅ Yes | *** ### ⚙️ Technical Notes - Works with **public hashtags** only — content must be publicly accessible on Instagram - Deduplication is built-in — no duplicate posts even across paginated requests - Failed requests are **automatically retried up to 3 times** with exponential backoff - The scraper handles all 3 Instagram audio data structures automatically *** ### 🧠 Use Cases **📈 Marketing & Growth** - Track trending hashtags in your niche to identify peak engagement windows - Monitor competitor brand hashtags for content and campaign intelligence **🎯 Influencer Research** - Discover emerging creators by filtering top-performing posts in a hashtag - Analyze follower counts, account types, and verification status at scale **🔊 Audio & Trend Intelligence** - Identify which songs and sounds are going viral in specific communities - Track `is_trending` audio signals before they peak **📍 Location-Based Insights** - Find geo-tagged content from specific cities or venues - Build location-aware content strategies using coordinate data **🛠️ Data Pipelines & Automation** - Feed structured Instagram data into analytics tools, CRMs, or dashboards - Schedule recurring runs to build time-series trend datasets *** ### ⚠️ Disclaimer This Actor collects only **publicly available data** — the same information visible to any unlogged visitor browsing Instagram. No private data, passwords, or personal messages are accessed. Use this tool responsibly and in accordance with applicable laws and platform terms. The developer assumes no liability for misuse. *** ### 💬 Support Experiencing issues or need a custom feature? Use the **Issues** tab on this Actor's page or reach out via the Apify community forum. Paid subscribers receive priority response. *** *Built for marketers, researchers, and developers who need reliable Instagram data — fast.* # Actor input Schema ## `hashtag` (type: `string`): Enter the Instagram hashtag to scrape (without #). Example: travel, fitness, reelsinstagram. ## `scrape_type` (type: `string`): Select which feed to scrape: Recent (latest posts) or Top (high-performing posts). ## `max_items` (type: `integer`): Maximum number of posts/reels to scrape. The scraper will stop once this limit is reached. ## `cursor` (type: `string`): Use a cursor from a previous run to continue scraping from where you left off. Leave empty to start from the beginning. ## Actor input object example ```json { "hashtag": "instagram", "scrape_type": "recent", "max_items": 24 } ``` # Actor output Schema ## `results` (type: `string`): Access all scraped posts and reels in JSON format from the dataset. # 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 = { "hashtag": "instagram", "scrape_type": "recent", "max_items": 24 }; // Run the Actor and wait for it to finish const run = await client.actor("breathtaking_anthem/instagram-hashtag-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 = { "hashtag": "instagram", "scrape_type": "recent", "max_items": 24, } # Run the Actor and wait for it to finish run = client.actor("breathtaking_anthem/instagram-hashtag-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 '{ "hashtag": "instagram", "scrape_type": "recent", "max_items": 24 }' | apify call breathtaking_anthem/instagram-hashtag-posts-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=breathtaking_anthem/instagram-hashtag-posts-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Instagram Hashtag Posts Scraper", "description": "Extract posts, reels, and media data from any public Instagram hashtag. Get engagement metrics, captions, trending audio, author profiles, and location data in clean JSON — no cookies or login needed.", "version": "0.0", "x-build-id": "0pzQ9QlpNYRxeQtGA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/breathtaking_anthem~instagram-hashtag-posts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-breathtaking_anthem-instagram-hashtag-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/breathtaking_anthem~instagram-hashtag-posts-scraper/runs": { "post": { "operationId": "runs-sync-breathtaking_anthem-instagram-hashtag-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/breathtaking_anthem~instagram-hashtag-posts-scraper/run-sync": { "post": { "operationId": "run-sync-breathtaking_anthem-instagram-hashtag-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", "required": [ "hashtag" ], "properties": { "hashtag": { "title": "Hashtag", "type": "string", "description": "Enter the Instagram hashtag to scrape (without #). Example: travel, fitness, reelsinstagram." }, "scrape_type": { "title": "Scrape Type", "enum": [ "recent", "top" ], "type": "string", "description": "Select which feed to scrape: Recent (latest posts) or Top (high-performing posts).", "default": "recent" }, "max_items": { "title": "Maximum Items", "minimum": 24, "type": "integer", "description": "Maximum number of posts/reels to scrape. The scraper will stop once this limit is reached.", "default": 24 }, "cursor": { "title": "Resume Cursor (Optional)", "type": "string", "description": "Use a cursor from a previous run to continue scraping from where you left off. Leave empty to start from the beginning." } } }, "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 } } } } } } } } } } ```