Instagram Graph API Limits: Business Discovery and Hashtag Search
The Instagram Graph API's Hashtag Search lets a professional account query at most 30 unique hashtags in a rolling 7-day period, doesn't cover hashtags on stories, and returns an error for hashtags Meta deems sensitive.
The Instagram Graph API’s Hashtag Search lets a professional account query at most 30 unique hashtags in a rolling 7-day period, doesn’t cover hashtags on stories, and returns an error for hashtags Meta deems sensitive. Hashtag Search and Business Discovery also fall under Platform Rate Limits, while the API’s other endpoints use Business Use Case rate limiting. Both features need the Facebook Login setup. Every official option is compared in the Instagram API guide.
These limits decide whether the official API can do your job, so it’s worth knowing them before you build. This guide covers each limit, from Meta’s documentation, and what to do when you hit them. The wider picture is in Instagram API in 2026. Where the official API stops, the best Instagram scrapers in 2026 compares the alternatives.
What Are the Instagram Hashtag Search Limits?
Meta’s Hashtag Search guide sets the rules below (Meta for Developers).
| Limit | Detail |
|---|---|
| Unique hashtags | 30 per Instagram Business or Creator account, per rolling 7 days |
| Repeat queries | Querying the same hashtag again within 7 days doesn’t count again and doesn’t reset its timer |
| Stories | Hashtags on stories aren’t supported |
| Sensitive hashtags | Return a generic error |
| Access | Requires the Instagram Public Content Access feature; Facebook Login for Business only |
The API offers top_media and recent_media edges for a hashtag, and a recently_searched_hashtags edge to see which hashtags an account has used up this week.
Which Rate Limits Apply?
All Instagram Platform endpoints use Business Use Case rate limiting, except Business Discovery and Hashtag Search, which use Platform Rate Limits. Meta states this in its Instagram Platform overview (Meta for Developers). Platform Rate Limits scale with your app’s usage, so check your app dashboard for current usage before scaling a job.
What Is Business Discovery?
Business Discovery lets your app read basic metadata and metrics about other Instagram Business and Creator accounts, without their authorisation. It’s the official way to look up competitors, but it only works for professional accounts and returns a limited set of fields. Personal accounts and follower lists aren’t covered.
Which Login Setup Do These Features Need?
Hashtag Search is only available with Facebook Login for Business; apps using Business Login for Instagram don’t get it. Facebook Login also requires business verification (Meta for Developers).
| Feature | Business Login for Instagram | Facebook Login for Business |
|---|---|---|
| Hashtag Search | No | Yes |
| Business verification | Not required | Required |
| API host | graph.instagram.com | graph.facebook.com |
What Can You Do When You Hit the Limits?
Prioritise the hashtags that matter most within the 30, re-use them within the 7-day window, or use a scraper for broad research. For tracking more than 30 hashtags a week, or for public accounts the API can’t read, scrapers are the practical route. apidojo’s Instagram Hashtag Scraper charges $0.016 per hashtag with the first 60 posts included, with no weekly hashtag cap (Apify). The trade-offs are in Instagram API vs Instagram scraper.
Questions people ask
Does re-querying a hashtag use up my limit?
No, repeat queries on the same hashtag within 7 days don't count again.
Can the Graph API search hashtags in stories?
No, stories aren't supported.
Can personal accounts use Hashtag Search?
No, it works on behalf of Business or Creator accounts.
Where do I check my rate limit usage?
In your Meta app's dashboard and the usage headers the API returns.