Back to Templates

Optimize Instagram hashtags with GPT-4o & real engagement data via Graph API

Created by

Created by: Shun Nakayama || nakayama

Shun Nakayama

Last update

Last update 20 days ago

Share


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

  1. Caption Input: Set your caption manually or via a workflow trigger.
  2. AI Suggestions: GPT-4o-mini analyzes the caption and suggests 10 relevant hashtags, balancing popular (big words) and niche keywords.
  3. 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.
  4. Selection & Sorting:
    • Sorts candidates by engagement metrics.
    • Selects the top 5 most effective hashtags that balance relevance and engagement.
  5. Output: Returns the final list of hashtags as text.

Setup Steps

  1. Import to n8n:

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

    • OpenAI account: Connect your OpenAI credentials.
    • Facebook Graph account: Connect your Facebook Graph API credentials.
  3. 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.
  4. 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.