Meta's API Restrictions
Meta’s API limits third-party platforms like Keyhole to a strict set of rules. To track Instagram data in Keyhole:
You must connect an Instagram Business or Creator profile
Each authenticated profile can track up to 30 unique hashtags within a rolling 7-day period
You’ll need to re-authenticate every 90 days or after a password change
📌 NOTE: To track hashtags effectively:
Each authenticated Instagram account adds 30 more hashtag slots
Once added, a hashtag counts toward your 30-limit until 7 days pass
Adding the same hashtag within the 7-day timer won’t free up or reset its slot
Authenticate Instagram for Listening & Campaigns
1. Go to Listening & Campaigns
2. Click Add New Tracker > Add Advanced Tracker
3. Enter your topic, select Instagram, and click Authenticate
4. Enter your Instagram credentials and grant permissions
5. Click Continue as [your name] to complete authentication
⭐ PRO TIP: Another way to add an account is by navigating to Profile > Settings > Connected Accounts and authenticating your Instagram account.
Manage Hashtag Limits
Once your 30-hashtag limit is reached, Keyhole will display:
“You've reached the maximum number of hashtags to collect public mentions from Instagram. Please authenticate another Instagram account to continue collecting data.”
1. To continue tracking, click Authenticate another Instagram account
2. Click Log in with Instagram professional
Authenticate Instagram for Profile Analytics
1. Go to Profile Analytics in Keyhole
2. Click Add New Profile > Add Any Public Profile > Instagram
3. Authenticate by clicking Log in with Instagram professional
4. Once authenticated, you can monitor metrics such as:
Impressions
Engagement (likes, comments, shares)
Reach
These metrics are only available for authenticated accounts.
Re-Authentication
Keyhole will notify you when your Instagram token expires (every 90 days or after a password change).
1. Click the Re-authenticate button in the notification
2. Follow the prompts to log in to Instagram and restore data collection
FAQs
Question | Answer |
Can I track more than 30 hashtags? | Yes, authenticate additional Instagram accounts to add 30 more hashtags per account. |
What if my Instagram token expires? | When your token expires (every 90 days or after a password change), re-authenticate by clicking the prompt in Keyhole to resume tracking. |
Can I track private Instagram accounts? | No, Keyhole only tracks public Instagram Business and Creator accounts. |
How often is Instagram data updated? | Keyhole refreshes Instagram data every 6 hours. |
I have reached my hashtag limit (or will soon), what should I do? | Add a new Instagram account. Or, review and remove unused hashtags, but note they count toward your limit for 7 days after removal. |
In advanced tracker settings, do "Do not include" hashtags count toward my limit? | No, only hashtags in the "Include" field count toward the limit. |
I removed a hashtag, but my active count hasn’t changed. Is this a bug? | No. Instagram’s policy applies a 7-day rolling limit on removed hashtags. For example, if you remove a hashtag on September 10th and your active count is 30/30, the slot frees up on September 17th. |
Get Help
For additional support, click the chat icon in the bottom right-hand corner and select I'm an existing customer and need support.