Optimize Instagram Hashtags with GPT-4o & Real Engagement Data via Graph API

Instagram Hashtag Generator Workflow

This workflow automatically generates optimal hashtags for your Instagram posts by analyzing captions and fetching real-time engagement data.

Key Features 100% Official API & Free**: Uses ONLY the official Instagram Graph API. No expensive third-party tools or risky scraping methods are required. Safe & Reliable**: Relying on the official API ensures compliance and long-term stability. Smart Caching**: Includes a Google Sheets caching mechanism to maximize the value of the official API's rate limits (30 searches/7 days).

Workflow Overview

Caption Input: Set your caption manually or via a workflow trigger. AI Suggestions: GPT-4o-mini analyzes the caption and suggests 10 relevant hashtags, balancing popular (big words) and niche keywords. Official API Search (Instagram Graph API): Fetches Hashtag IDs using the ig_hashtag_search endpoint. Retrieves engagement metrics (Average Likes, Average Comments) using the ID. Selection & Sorting: Sorts candidates by engagement metrics. Selects the top 5 most effective hashtags that balance relevance and engagement. Output: Returns the final list of hashtags as text.

Setup Steps

Import to n8n: Copy the content of workflow_hashtag_generator.json and paste it into your n8n canvas, or import the file directly.

Credentials: OpenAI account: Connect your OpenAI credentials. Facebook Graph account: Connect your Facebook Graph API credentials.

Configuration: Instagram Business ID: Update the YOUR_INSTAGRAM_BUSINESS_ACCOUNT_ID placeholder in the Get Hashtag Info and Get Hashtag Metrics nodes with your actual Business Account ID. Google Spreadsheet ID: Update the YOUR_SPREADSHEET_ID placeholder in the Fetch Cached Hashtags and Save to Cache nodes.

Adjustments: Filter Logic: You can adjust the sorting or filtering logic in the Aggregate & Rank Candidates node's JavaScript code (e.g., exclude tags with fewer than 1000 posts) if needed.

Important Notes on API Limits The official Instagram Hashtag Search API (ig_hashtag_search) allows for 30 unique hashtag queries per rolling 7-day period. Why this is fine**: This workflow caches results in Google Sheets. Once a tag is fetched, it doesn't need to be queried again for a while, allowing you to build up a large database of tags over time without hitting the limit. Recommendation**: Use mock data during initial testing to save your API quota.