# Instagram Hashtag Scraper — Posts, Reels & Creator Discovery (`monkey.d.scraping/instagram-hashtag-scraper`) Actor

Find recent and top Instagram posts and reels by hashtag. Discover creators, explore hashtag analytics and export captions, available engagement metrics and the first 20 comments per post.

- **URL**: https://apify.com/monkey.d.scraping/instagram-hashtag-scraper.md
- **Developed by:** [Monkey D. Scraping](https://apify.com/monkey.d.scraping) (community)
- **Categories:** Social media, Lead generation, MCP servers
- **Features:** Limited permissions, Single-tenant, Server interface
- **Stats:** 4 total users, 1 monthly users, 98.8% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event + usage

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Instagram Hashtag Scraper — Posts, Reels & Creator Discovery

Discover Instagram content and creators by hashtag. Collect recent and top posts and reels, explore related hashtags and creator lists, and use available engagement metrics to research campaigns, competitors and content ideas.

![Instagram Hashtag Scraper — Posts, Reels & Creator Discovery](https://api.apify.com/v2/key-value-stores/cejrg8lYOF5DWaNKX/records/hashtag-positioning-v3.svg)

**中文用户：** [简体中文说明](#中文说明instagram-话题标签hashtag帖子与-reels-采集与分析工具) · **中文用戶：** [繁體中文說明](#中文說明繁體instagram-主題標籤hashtag貼文與-reels-擷取與分析工具)

**From $0.30 per 1,000 results, about 5 times less than the market leader. No start fee, no login, no cookies.** Type a hashtag or a search term and get the **recent posts** (photos, carousels and reels of the last day, week, month or year) and the **top results**: the reels Instagram ranks first or, for hashtags Instagram does not rank, the most liked posts and reels of any date. You can also paste links to posts and reels. Every result comes with likes, comment count, publication date, caption, hashtags, audio, video link, duration and engagement rates, plus views for the reels Instagram ranks. **The first 20 comments of each post, the hashtag analytics and the creator list are included in the same price.**

One Actor instead of four: Instagram hashtag scraper, Instagram post scraper, hashtag analytics tool and creator finder in a single run. Output ready for Google Sheets, Excel, n8n, Make, Zapier, Python, JavaScript, the Apify MCP server and AI agents.

### Why this Instagram hashtag scraper?

| | This Actor | Market leader | Typical low-cost scrapers |
| --- | --- | --- | --- |
| Price per 1,000 posts or reels | **$0.50 → $0.30** | $2.60 → $1.90 | $0.24 – $0.45 |
| Start fee or fee per hashtag | **none** | none | often |
| Recent posts and top reels in the same run | ✅ | recent only | one of the two |
| Photos, carousels and reels | ✅ | ✅ | partial |
| Only posts with the exact hashtag | ✅ | ✅ | rare |
| Comments | ✅ **20 per post included** | separate Actor, $2.60 → $1.90 per 1,000 | ❌ or separate Actor |
| Hashtag analytics (averages, related hashtags, top creators, top audio, best posting times) | ✅ **included** | separate Actor, from $1.40 per 1,000 | ❌ |
| Creator list with posts and views | ✅ **included** | ❌ | ❌ |
| Like rate, engagement per view, views per day | ✅ | ❌ | ❌ |
| Audio title and artist, video link, duration | ✅ | partial | partial |
| Filters: date, minimum views, minimum likes (filtered results are free) | ✅ | date only | rare |
| Monitor: only the posts not returned before | ✅ | ❌ | ❌ |
| Real-time API endpoint (Server mode) | ✅ | ❌ | rare |
| Documentation in English and Chinese | ✅ | ❌ | ❌ |

Prices and features read from the Apify Store listings on 11 November 2026; Free plan → highest plan.

**Where it is better:**

- **About 5 times cheaper** than the market leader, with the first 20 comments of every post included instead of a second paid Actor.
- **Recent and top in one run:** what was just posted and what performs best, side by side, each row marked `recent` or `top`.
- **Analytics for free:** related hashtags, top creators, top audio and best posting times for every hashtag, without a separate tool.
- **Ready-made metrics:** like rate, engagement per view, views per day and post age on every row, no spreadsheet formulas needed.
- **Pay only for what you keep:** results removed by your filters and items that cannot be read are never charged.

### What can I do with it?

- **Hashtag research:** see what is being published under a hashtag right now and what performs best, which hashtags are used together with it, at what time top reels are published and which songs they use.
- **Trend and viral content monitoring:** schedule a task and receive only the posts and reels that were not there in the previous run.
- **Brand and campaign tracking:** follow a branded hashtag or a product name, with likes, views and the first comments of every post.
- **Influencer and UGC creator discovery:** get the creators who post in a niche, with their posts and views.
- **Competitor and market analysis:** compare hashtags by average views, like rate, share of verified accounts and share of sponsored content.
- **Content ideas and AI workflows:** feed captions, hashtags, comments and video links to an LLM for summaries, hooks, scripts and sentiment analysis.
- **Post and reel details by link:** paste a list of links and get the same fields for each one.

### How to scrape Instagram hashtags

1. Open the Actor and type one or more hashtags or search terms (`coffee`, `#skincare`, `milano fashion week`).
2. Choose recent posts, top results or both, and how many results you want for each hashtag.
3. Optional: ask for more comments, a date, a minimum number of views or likes.
4. Click **Start**. Download the results as JSON, CSV or Excel, or read them through the API.

### Input

| Field | What it does |
| --- | --- |
| `hashtags` | Hashtags, search terms of several words or hashtag links, one per line. |
| `postUrls` | Links to single posts, reels or videos. |
| `resultsType` | `all` (recent and top, default), `recent` or `top`. Top results are the reels Instagram ranks first; for hashtags Instagram does not rank, the most liked posts and reels of any date. |
| `recentPeriod` | Recent means the last `day`, `week` (default), `month` or `year`. |
| `contentType` | `all`, `posts` (photos and carousels) or `reels`. |
| `maxResultsPerHashtag` | Results kept for each hashtag. `0` = everything found. Default 50. |
| `exactHashtagOnly` | Keep only results with the exact hashtag in the caption (for a search term of several words, every word). Off by default: recent results then also include posts that name the term without the #, such as a brand written in plain text. |
| `includeRelatedSearches` | Also read close wordings and related searches of the hashtag: more top reels per hashtag. |
| `includeDetails` | Likes, comment count, date, audio, tags and collaborations, plus the calculated rates. Turn off for a faster list of top reels. |
| `commentsPerPost` | Latest comments of each post. The first 20 are inside the post row at no extra cost. |
| `postedAfter` | Only results published on or after this day. |
| `minViews`, `minLikes` | Only results above these numbers. Results filtered out are not charged. `minViews` keeps only reels with a known view count, so it returns top reels only (see the FAQ on views). |
| `onlyNewReels` | For scheduled tasks: only the posts and reels that earlier runs of the same task did not return. |

#### Example inputs

Recent posts and top reels of two hashtags, with their analytics:

```json
{ "hashtags": ["coffee", "#latteart"], "maxResultsPerHashtag": 50 }
```

What was posted under a hashtag in the last 24 hours, photos and carousels only:

```json
{ "hashtags": ["skincare"], "resultsType": "recent", "recentPeriod": "day", "contentType": "posts", "maxResultsPerHashtag": 100 }
```

The most viewed reels of a niche, fast:

```json
{ "hashtags": ["vegan recipes"], "resultsType": "top", "maxResultsPerHashtag": 100, "minViews": 50000 }
```

Monitor a branded hashtag every day, new posts only, with comments:

```json
{ "hashtags": ["#nikerunning"], "onlyNewReels": true, "commentsPerPost": 20 }
```

Details and comments of specific reels:

```json
{ "postUrls": ["https://www.instagram.com/reel/DQr0leHAWYa/"], "commentsPerPost": 100 }
```

### Output

The run produces four tables and a summary.

**Posts and reels** (default dataset), one row each:

```json
{
  "postUrl": "https://www.instagram.com/p/DQr0leHAWYa/",
  "type": "reel",
  "hashtag": "coffee",
  "listedAs": "recent",
  "position": 1,
  "ownerUsername": "sipsbylilly",
  "ownerIsVerified": true,
  "caption": "daily affirmations … #icedcoffee #coffee #coffeeislife",
  "createdAt": "2026-11-09T18:24:16Z",
  "videoViewCount": 122908,
  "likeCount": 4508,
  "commentCount": 199,
  "likeRate": 3.668,
  "engagementPerView": 3.684,
  "viewsPerDay": 61454,
  "hashtags": ["icedcoffee", "coffee", "coffeeislife"],
  "audioTitle": "Mimosa 2000",
  "audioArtist": "Furacão 2000, Nyasia",
  "videoDurationSec": 9.61,
  "videoUrl": "https://…mp4",
  "comments": [
    { "text": "😍😍", "authorUsername": "mycoffeetales.app", "likeCount": 0, "createdAt": "2026-11-11T10:56:24Z" }
  ]
}
```

`listedAs` is `recent` or `top`; `position` is the rank of a top result. Other fields: `postId`, `shortcode`, `ownerProfileUrl`, `ageDays`, `commentRate`, `mentions`, `taggedUsers`, `collaborators`, `possiblySponsored`, `sponsoredSignals`, `locationName`, `displayUrl`, `images`, `hasAudio`, `audioId`, `isOriginalAudio`, `countsHidden`, `hashtagsInAuthorComments`, `createdAtSource`, `detailsRead`, `inputValue`, `scrapedAt`.

Every result has its publication date. It comes from the post page (`createdAtSource: post`) or, when Instagram does not show that page at the moment, from the post id, which records the upload time within a few minutes of publication (`createdAtSource: postId`). `detailsRead` says whether likes, comments, audio and the first comments were read from the post page.

**Hashtag analytics** (dataset `hashtags`), one row per hashtag: `reelsOnInstagram`, `reelsAnalyzed`, `totalViews`, `avgViews`, `medianViews`, `avgLikes`, `avgComments`, `avgLikeRate`, `avgEngagementPerView`, `avgViewsPerDay`, `avgDurationSec`, `medianAgeDays`, `uniqueCreators`, `verifiedShare`, `sponsoredShare`, `topCreators`, `relatedHashtags`, `relatedSearches`, `topAudio`, `bestPostingHoursUtc`, `bestPostingDays`, `topReels`, `topRanking` (`instagram` when top results follow Instagram's ranking, `mostLiked` when Instagram does not rank the hashtag and they are its most liked posts and reels).

**Creators** (dataset `creators`), one row per account found: `username`, `profileUrl`, `isVerified`, `reelsInResults`, `totalViews`, `avgViews`, `avgLikes`, `topReelUrl`, `foundInHashtags`.

**Extra comments** (dataset `comments`): the comments beyond the 20 included in each post row, with author, text, time, likes and link. To download them, pick **Extra comments** in the Output tab or in the Export menu: exporting **Reels and posts** gives the first 20 inside each row.

**Summary** (record `SUMMARY`): the status of every hashtag and link, with the reason when something could not be read. For a hashtag with no results, `emptyCause` gives the reason; for one with top results but no recent posts, `recentNote` does. `topListOnInstagram` says whether Instagram publishes a public top list for the hashtag. The run's final status message sums these up in plain words.

### Pricing

Pay only for what you get. No start fee, no fee per hashtag, no monthly rent.

| Event | Free | Starter | Scale | Business and above |
| --- | --- | --- | --- | --- |
| Post or reel, with details, rates and its first 20 comments | $0.50 / 1,000 | $0.40 / 1,000 | $0.35 / 1,000 | $0.30 / 1,000 |
| Extra comment (beyond the first 20 of a post) | $0.30 / 1,000 | $0.27 / 1,000 | $0.23 / 1,000 | $0.20 / 1,000 |

Hashtag analytics rows, creator rows and the run summary are free. Results removed by your filters and items that cannot be read are not charged.

**Example:** 1,000 posts and reels of 20 hashtags with likes, dates, audio, 20 comments each, 20 analytics rows and the creator list cost $0.50 on the Free plan. The same data from the market leader needs three Actors and costs more than $50.

### Use it from code, Make, n8n, Zapier or an AI agent

**API (Python):**

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("monkey.d.scraping/instagram-hashtag-scraper").call(
    run_input={"hashtags": ["coffee"], "maxResultsPerHashtag": 50}
)
for post in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(post["postUrl"], post["listedAs"], post["likeCount"])
```

**API (curl), run and get the results in one call:**

```bash
curl -X POST "https://api.apify.com/v2/acts/monkey.d.scraping~instagram-hashtag-scraper/run-sync-get-dataset-items?token=<YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"hashtags": ["coffee"], "resultsType": "top", "maxResultsPerHashtag": 20}'
```

**Make, n8n, Zapier:** use the Apify integration, choose this Actor and map the fields of the dataset to Google Sheets, Airtable, Slack or your CRM. Schedule the task with `onlyNewReels` to receive only new posts.

#### Real-time Instagram hashtag API for apps and AI agents (Server mode)

The Actor also answers plain HTTP requests, with the results in the response:

```bash
curl "https://monkey-d-scraping--instagram-hashtag-scraper.apify.actor/scrape?hashtag=coffee&resultsType=top&maxResultsPerHashtag=12" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"
```

The response contains `posts`, `hashtags` (analytics), `creators`, `comments` and a `summary`. `POST /scrape` accepts the same JSON as a normal run. Same prices as a normal run; items that cannot be read are free. Single-tenant and multi-tenant server modes are supported.

#### Use it as a tool in Claude, ChatGPT, Cursor and other MCP clients

Add the Apify MCP server with this Actor as a tool:

```
https://mcp.apify.com?tools=monkey.d.scraping/instagram-hashtag-scraper
```

Then ask: "What was posted under #skincare this week, which hashtags go with it and who are the top creators?" The agent calls the Actor and reads the results and the analytics row.

### For AI agents and LLM tools

- **What it returns:** public Instagram posts and reels for a hashtag or search term (recent ones from the chosen period and top reels), plus per-hashtag analytics and the creators behind them; public posts and reels by link.
- **Minimal input:** `{"hashtags": ["coffee"]}`. Useful options: `resultsType`, `recentPeriod`, `contentType`, `maxResultsPerHashtag`, `commentsPerPost`, `postedAfter`, `minViews`, `onlyNewReels`.
- **Where the data is:** default dataset = posts and reels; datasets `hashtags`, `creators`, `comments`; key-value record `SUMMARY`.
- **Cost model:** one event per post or reel saved; extra comments are a separate event; analytics and creators are free.
- **Fast answers:** `resultsType: "top"` returns in seconds.

### FAQ

**Do I need an Instagram account, cookies or a proxy?** No. Type the hashtags and start.

**Which results do I get for a hashtag?** With the default `all`, half are recent posts from the chosen period that carry the hashtag or name the term in the caption, and half are the top results. Choose `recent` or `top` to get only one kind.

**Where do top results come from?** For popular hashtags they are the reels Instagram ranks first, in its order. Instagram ranks only part of the hashtags: for niche ones, such as a product or an active ingredient, top results are the most liked posts and reels of any date that carry the hashtag, sorted by likes and comments. `topRanking` in the `hashtags` table and in `SUMMARY` says which of the two you got.

**Why do some reels have no views?** Instagram shows view counts to logged-out visitors only in its ranked reel lists. Top results from those lists have `videoViewCount`; recent results and the most liked posts of niche hashtags come with likes, comments and every other field, but `videoViewCount` is empty. The scraper never estimates or fills in a missing number.

**Do I get photos and carousels?** Yes: photos, carousels and reels, by hashtag and by link.

**Can I search with several words, not only hashtags?** Yes: `milano fashion week`, `home workout` or a brand name work like a hashtag.

**How fast is it?** Top reels arrive in seconds, and several hashtags are read in parallel in the same run.

**How do I monitor a hashtag?** Save a task with `onlyNewReels`, schedule it and connect a webhook or an integration. Each run returns only posts that the task did not return before.

**Are comments really included?** Yes, the first 20 comments of each post are inside the post row. Ask for more with `commentsPerPost`; the extra ones are saved in the `comments` table.

**What happens when a hashtag cannot be read?** It is reported in `SUMMARY` with the reason and nothing is charged for it.

**Why does a hashtag return no results?** Instagram does not publish a public top list for every hashtag: it leaves it out for some terms, often sensitive ones such as health or political topics. For those hashtags the results are the recent posts found on the web that carry the hashtag. If none are found in the chosen period, or Instagram does not show their pages at that moment, the hashtag is reported with the reason in `SUMMARY` and in the run's final status, and nothing is charged. A longer `recentPeriod` or another wording often helps.

**What if Apify moves my run to another server?** Long runs are sometimes moved by the platform. The run continues where it stopped: hashtags already finished are skipped and posts already saved are neither saved nor charged again.

**Can I analyse posts over time?** Yes. Every result has `createdAt`, also when Instagram does not show the post page (the date then comes from the post id, see `createdAtSource`), so you can group results by day, week or month.

**Is it legal to scrape Instagram?** The Actor reads only public content, without login. You are responsible for how you use the data: respect privacy laws such as GDPR and Instagram's terms, and do not use personal data without a lawful basis.

**Can I export to Google Sheets, Excel or CSV?** Yes, from the Output tab or through the API and the integrations.

### Chinese Simplified

### 中文说明：Instagram 话题标签（Hashtag）帖子与 Reels 采集与分析工具

**每 1,000 条结果低至 $0.30，约为市场主流工具的五分之一。无启动费，无需登录，无需 Cookie。** 输入话题标签或关键词（如 `coffee`、`#skincare`、`milano fashion week`），即可获得**最新帖子**（最近一天、一周、一个月或一年的图片、轮播和 Reels）以及**热门结果**（Instagram 排名靠前的 Reels；Instagram 未排名的小众话题则为不限日期、点赞最多的帖子与 Reels）；也可粘贴帖子与 Reels 链接。每条结果包含点赞数、评论数、发布时间、文案、标签、音乐、视频链接、时长和互动率；Instagram 排名的 Reels 另含播放量（最新结果不含播放量）。**每条帖子的前 20 条评论、话题分析和创作者列表均包含在同一价格内。**

#### 为什么选择这款 Instagram 采集工具？

- **价格低：** $0.50 → $0.30 / 1,000 条，市场主流工具为 $2.60 → $1.90。
- **最新与热门同时获取：** 图片、轮播和 Reels，可只保留带有精确标签的内容。
- **评论包含在内：** 每条帖子前 20 条评论免费。
- **话题分析免费：** 平均播放量、中位数、点赞率、相关标签、头部创作者、热门音乐、最佳发布时间。
- **筛选与监控：** 按日期、最低播放量、最低点赞数筛选（被筛掉的不收费）；定时任务只返回新内容。
- **API、实时接口（Server 模式）与 MCP：** 适用于 Python、n8n、Make、Zapier 和 AI 智能体。

#### 适用场景

跨境电商选品与竞品分析、海外社媒营销、网红（KOL / KOC）筛选、品牌舆情监测、热门内容与爆款趋势追踪、AI 内容创作素材收集。

#### 使用方法

1. 在 `hashtags` 中每行输入一个话题标签或关键词。
2. 选择 `resultsType`：`all`（最新与热门）、`recent` 或 `top`；`recentPeriod` 设定时间范围。
3. 可选：`commentsPerPost`、`postedAfter`、`minViews`、`onlyNewReels`。
4. 点击 **Start**，导出 JSON、CSV 或 Excel，或通过 API 读取。

```json
{ "hashtags": ["skincare", "护肤"], "resultsType": "recent", "recentPeriod": "week", "maxResultsPerHashtag": 50 }
```

#### 价格

| 计费项 | Free | Starter | Scale | Business 及以上 |
| --- | --- | --- | --- | --- |
| 每条帖子或 Reels（含详情与前 20 条评论） | $0.50 / 1,000 | $0.40 / 1,000 | $0.35 / 1,000 | $0.30 / 1,000 |
| 额外评论 | $0.30 / 1,000 | $0.27 / 1,000 | $0.23 / 1,000 | $0.20 / 1,000 |

话题分析与创作者列表免费；无法读取或被筛掉的内容不收费。

#### 常见问题

**需要 Instagram 账号或代理吗？** 不需要。

**支持中文关键词吗？** 支持，中文、日文、韩文等标签和关键词均可。

**可以获取图文帖子吗？** 可以，最新结果包含图片和轮播，也可以把链接填入 `postUrls`。

**热门结果从哪里来？** 热门话题使用 Instagram 排名靠前的 Reels，保持其顺序。Instagram 只为部分话题提供排名：对于产品名、成分名等小众话题，热门结果是带有该标签、不限日期、点赞最多的帖子和 Reels，按点赞与评论数排序。`hashtags` 表和 `SUMMARY` 中的 `topRanking` 会注明来源（`instagram` 或 `mostLiked`）。

**为什么某些话题没有结果？** Instagram 并不为所有话题公开热门列表，部分话题（常见于健康、政治等敏感话题）没有。此类话题的结果来自网络上找到的、带有该标签的最新帖子；如果所选时间范围内没有找到，或 Instagram 暂时不显示这些帖子页面，`SUMMARY` 中的 `emptyCause` 和运行结束时的状态信息会说明原因，且不收费。可以尝试更长的 `recentPeriod` 或其他写法。

**Apify 把运行迁移到另一台服务器怎么办？** 较长的运行偶尔会被平台迁移。运行会从中断处继续：已完成的话题会跳过，已保存的帖子不会重复保存，也不会重复收费。

**每条结果都有发布日期吗？** 有。`createdAt` 来自帖子页面；当 Instagram 暂时不显示该页面时，日期取自帖子 ID 中记录的上传时间（与发布时间相差几分钟），`createdAtSource` 会注明来源（`post` 或 `postId`），`detailsRead` 表示点赞、评论等是否已从帖子页面读取。

**如何用于 AI 智能体？** 使用 Apify MCP：`https://mcp.apify.com?tools=monkey.d.scraping/instagram-hashtag-scraper`，或调用实时接口 `/scrape?hashtag=coffee`。

### Chinese Traditional

### 中文說明（繁體）：Instagram 主題標籤（Hashtag）貼文與 Reels 擷取與分析工具

**每 1,000 則結果低至 $0.30，約為市場主流工具的五分之一。無啟動費，免登入，免 Cookie。** 輸入主題標籤或關鍵字，即可取得**最新貼文**（圖片、輪播與 Reels）與**熱門結果**（Instagram 排名靠前的 Reels；未排名的小眾標籤則為不限日期、按讚最多的貼文與 Reels），或貼上貼文與 Reels 連結。每則結果包含按讚數、留言數、發布時間、文案、標籤、音樂、影片連結、時長與互動率；Instagram 排名的 Reels 另含觀看次數（最新結果不含觀看次數）。**每則貼文的前 20 則留言、標籤分析與創作者清單都包含在同一價格內。**

#### 為什麼選擇這款 Instagram 爬蟲？

- 價格 $0.50 → $0.30 / 1,000 則，市場主流工具為 $2.60 → $1.90。
- 最新與熱門一次取得，可只保留帶有精確標籤的內容。
- 標籤分析免費：平均觀看、按讚率、相關標籤、熱門創作者、熱門音樂、最佳發文時間。
- 依日期、最低觀看數、最低按讚數篩選；排程任務只回傳新內容。
- 支援 API、即時介面（Server 模式）與 MCP。

#### 使用方法

```json
{ "hashtags": ["咖啡", "#台北美食"], "maxResultsPerHashtag": 50, "commentsPerPost": 20 }
```

#### 常見問題

**需要 Instagram 帳號嗎？** 不需要。

**熱門結果從哪裡來？** 熱門主題標籤使用 Instagram 排名靠前的 Reels，保持其順序。Instagram 只為部分標籤提供排名：產品名、成分名等小眾標籤的熱門結果，是帶有該標籤、不限日期、按讚最多的貼文與 Reels，依按讚與留言數排序。`hashtags` 表與 `SUMMARY` 中的 `topRanking` 會註明來源（`instagram` 或 `mostLiked`）。

**為什麼某些標籤沒有結果？** Instagram 並未為所有標籤公開熱門列表，部分標籤（常見於健康、政治等敏感主題）沒有。這類標籤的結果來自網路上找到、帶有該標籤的最新貼文；若所選期間內沒有找到，或 Instagram 暫時不顯示這些貼文頁面，`SUMMARY` 中的 `emptyCause` 與執行結束時的狀態訊息會說明原因，且不收費。可以嘗試更長的 `recentPeriod` 或其他寫法。

**Apify 把執行遷移到另一台伺服器怎麼辦？** 較長的執行偶爾會被平台遷移。執行會從中斷處繼續：已完成的標籤會略過，已儲存的貼文不會重複儲存，也不會重複收費。

**每筆結果都有發布日期嗎？** 有。`createdAt` 來自貼文頁面；當 Instagram 暫時不顯示該頁面時，日期取自貼文 ID 記錄的上傳時間（與發布時間相差幾分鐘），`createdAtSource` 會註明來源（`post` 或 `postId`），`detailsRead` 表示按讚、留言等是否已從貼文頁面讀取。

**可以匯出到 Google 試算表或 Excel 嗎？** 可以，從 Output 分頁或透過 API 匯出。

### Related Actors by the same author

- [Instagram Profile, Reels & Keyword Search Scraper](https://apify.com/monkey.d.scraping/instagram-profile-scraper): profiles with all their posts and reels, engagement rate and best posting times.
- [Instagram Comments Scraper](https://apify.com/monkey.d.scraping/instagram-comments-scraper): every comment of posts and reels.
- [YouTube Scraper](https://apify.com/monkey.d.scraping/youtube-scraper): videos, Shorts, transcripts and comments.
- [Facebook Page Posts Scraper & Monitor](https://apify.com/monkey.d.scraping/facebook-page-posts-scraper), [Facebook Comments Scraper](https://apify.com/monkey.d.scraping/facebook-comments-scraper) and [Facebook Groups Scraper](https://apify.com/monkey.d.scraping/facebook-groups-scraper).
- [Telegram Channel Scraper](https://apify.com/monkey.d.scraping/telegram-channel-scraper) and [Telegram Keyword Search](https://apify.com/monkey.d.scraping/telegram-keyword-search).
- [TikTok Ads Library Scraper](https://apify.com/monkey.d.scraping/tiktok-ads-library-scraper), [Bilibili Scraper](https://apify.com/monkey.d.scraping/bilibili-scraper) and [Lemon8 Scraper](https://apify.com/monkey.d.scraping/lemon8-scraper).

# Actor input Schema

## `hashtags` (type: `array`):

One per line: a hashtag (coffee or #coffee), a search term of several words (milano fashion week) or a hashtag link. Each one returns recent posts and reels with that hashtag or naming the term, and the top reels Instagram lists for it, from any public account, plus an analytics row.

## `resultsType` (type: `string`):

Recent results are photos, carousels and reels published in the chosen period that carry the hashtag. Top results are the reels Instagram ranks first; for hashtags Instagram does not rank, the most liked posts and reels of any date.

## `recentPeriod` (type: `string`):

Period for recent results.

## `maxResultsPerHashtag` (type: `integer`):

Posts and reels kept for each hashtag. 0 = everything found.

## `postUrls` (type: `array`):

Links to single posts, reels or videos (instagram.com/p/…, /reel/…). Each link returns that post with its details.

## `contentType` (type: `string`):

Photos and carousels, reels, or both.

## `exactHashtagOnly` (type: `boolean`):

Keep only posts and reels with the exact hashtag in the caption (for a search term of several words, every word). When off, recent results also include posts that name the term without the #, such as a brand in plain text. Results filtered out are not charged.

## `includeRelatedSearches` (type: `boolean`):

Also read close wordings and related searches of the hashtag (for example "iced coffee" and "coffee tips" for "coffee"): many more top reels per hashtag, up to the maximum above.

## `includeDetails` (type: `boolean`):

Likes, comment count, publication date, audio, tags and collaborations of every result, plus like rate and views per day. Turn off for the fastest list of top reels with views, caption, author and video link.

## `commentsPerPost` (type: `integer`):

Latest comments of each post. The first 20 are included in the post row at no extra cost; further ones are saved as comment rows.

## `postedAfter` (type: `string`):

Keep only results published on or after this day (00:00 UTC). Leave empty for all dates.

## `minViews` (type: `integer`):

Keep only results with at least this many views. 0 = no filter. Reels filtered out are not charged.

## `minLikes` (type: `integer`):

Keep only results with at least this many likes. 0 = no filter. Reels filtered out are not charged.

## `onlyNewReels` (type: `boolean`):

For scheduled tasks: each run returns only the posts and reels that earlier runs of the same task did not return for that hashtag. The first run returns everything.

## Actor input object example

```json
{
  "hashtags": [
    "coffee"
  ],
  "resultsType": "all",
  "recentPeriod": "week",
  "maxResultsPerHashtag": 50,
  "postUrls": [],
  "contentType": "all",
  "exactHashtagOnly": false,
  "includeRelatedSearches": false,
  "includeDetails": true,
  "commentsPerPost": 0,
  "minViews": 0,
  "minLikes": 0,
  "onlyNewReels": false
}
```

# Actor output Schema

## `posts` (type: `string`):

One row per reel or post with views, likes, comments, audio, rates and the first comments.

## `hashtags` (type: `string`):

One row per hashtag: averages, related hashtags, top creators, top audio and best posting times.

## `creators` (type: `string`):

One row per creator found, with reels and views; followers and bio when requested.

## `comments` (type: `string`):

Comments beyond the 20 included in each reel row, when requested.

## `summary` (type: `string`):

Status of every hashtag and link, with the reason when something could not be read.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "hashtags": [
        "coffee"
    ],
    "maxResultsPerHashtag": 50,
    "postUrls": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("monkey.d.scraping/instagram-hashtag-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "hashtags": ["coffee"],
    "maxResultsPerHashtag": 50,
    "postUrls": [],
}

# Run the Actor and wait for it to finish
run = client.actor("monkey.d.scraping/instagram-hashtag-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "hashtags": [
    "coffee"
  ],
  "maxResultsPerHashtag": 50,
  "postUrls": []
}' |
apify call monkey.d.scraping/instagram-hashtag-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,monkey.d.scraping/instagram-hashtag-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/0DiNTBf883C0jd9p6/builds/MyJGzzUJAq7u9PAua/openapi.json
