Instagram Hashtag Discovery — Co-occurrence Discovery + Competition Tier

Turns your Instagram posts (your own data or a connected IG scraper dataset) into plannable hashtag intelligence: the hashtags that are actually used together (related tags), a competition tier (nano→mega), and a concrete content strategy. It doesn't scrape — it's an intelligence layer: no anti-bot, no proxy, no blocking headaches.

How it works (BYOD)

This actor does not scrape Instagram. You supply the post data — paste a list of posts with captions OR connect the dataset of any Instagram scraper actor to this input. We do the valuable part: from those captions we compute, via co-occurrence, which hashtags work together. (Same pattern as a Maps/Lead Enricher: a post-scraper intelligence layer.)

Why this actor

1. Real discovery (co-occurrence) — most tools just dump posts; we surface which tags are used together, plus a strength ratio.
2. Competition tier + action — provide postCounts and you get nano/micro/mid/macro/mega plus a concrete strategy per tier (USE / MIX / SPRINKLE …) and a relevance-ranked "add these tags first" list.
3. No anti-bot — because we don't scrape, we don't break when Instagram changes its layout; unbreakable + high margin.
4. Robust normalization + dedup — Unicode-safe (including non-Latin scripts); hidden likes handled safely; multi-seed pool merged.
5. Honest billing — you pay per run plus per seed hashtag actually analyzed.

Input

Field	Description
posts	Instagram posts (with captions). Your own data or a connected IG scraper dataset. Required.
seedHashtags	The seeds to run related-tag discovery for. If empty, the most frequent tags in the posts are auto-selected.
postCounts	Seed → total post count on Instagram (optional) → the competition tier is computed from this.
relatedLimit	Maximum number of related hashtags per seed.

Output

Dataset (one row per seed):

hashtag, post_count, competition_tier, strategy {action, reason}, recommended_hashtags [{rank, tag, relevance, co_occurrence_ratio}], related_hashtags [{tag, co_occurrence, co_occurrence_ratio}], engagement {sample_size, avg_likes, avg_comments, avg_engagement}.

Key-value store:

• RELATED_POOL — the merged, deduplicated related-hashtag pool across all seeds.
• RUN_SUMMARY — seeds_analyzed, input_post_count, seeds, post_counts_provided.

How to use

1. Collect your Instagram posts with a scraper (or paste in your own list of posts with captions).
2. Connect the output to this actor as posts.
3. (Optional) Set seedHashtags and postCounts → Start.
4. Grab the related hashtags, competition tiers, and recommendations from the Dataset tab.

Pricing (Pay-Per-Event)

You only pay for what you use: per run + per seed hashtag analyzed. No live scraping or proxy cost, so the margin is high — and there's no monthly subscription.