Instagram Hashtag Posts
Instagram hashtag posts are public photos or Reels associated with a searched hashtag, carrying captions, creator identity, media, timestamps, and visible engagement. Those content and provenance signals support topic discovery, cross-hashtag comparison, creator research, and time-bounded monitoring.
Features
- Multi-hashtag collectionSubmit one or more hashtags with or without #, with results_limit applied separately to every submitted hashtag.
- Time and media filtersLimit discovery to the last hour, day, week, month, or year and choose all posts or Reels only.
- Normalized post recordsReceive post IDs, shortcodes, canonical URLs, captions, author details, media references, hashtags, mentions, and timestamps in one shape.
- Source context and engagementRetain the submitted hashtag that produced each record together with available like, comment, view, and play counts.
Parameters
| Parameters | Required | Description |
|---|---|---|
hashtags | Required | One or more non-empty hashtags, with or without #, separated by commas or new lines. |
results_limit | Optional | Maximum records requested per hashtag; defaults to 100 and accepts integers from 10 through 2,000. |
published_within | Optional | Optional publication window: hour, day, week, month, or year. |
media_type | Optional | Content filter; all includes supported post types and reels restricts results to Reels. |
How to Use
Submit hashtags as an asynchronous task, poll its task ID, then read normalized post records with cursor pagination.
- Prepare one or more unique hashtags, with or without a leading #.
- POST hashtags and optional results_limit, published_within, and media_type fields to /v1/instagram/hashtag-posts.
- Poll /v1/tasks/{task_id} until the status is succeeded or failed.
- Read /v1/tasks/{task_id}?limit=50 and follow results.next_cursor while results.has_more is true.
curl -X POST "https://api.socq.ai/v1/instagram/hashtag-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtags":["travel","photography"],"results_limit":20,"published_within":"week","media_type":"all"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueBest Use Cases
- Topic content discovery: Build reviewable datasets of public posts associated with campaign, event, community, or industry hashtags.
- Cross-hashtag comparison: Compare visible engagement and content patterns while preserving the submitted hashtag that produced every record.
- Recent Reels monitoring: Combine a publication window with the Reels-only filter to review timely short-form content around selected hashtags.
- Creator and content enrichment: Join post identity, author context, captions, media, and visible metrics with research, campaign, or moderation records.
Pro Tips
- Deduplicate input hashtags and use one spelling for each topic; the collector processes every submitted value independently.
- Plan volume per hashtag because results_limit applies to each hashtag rather than the request as a whole.
- Use published_within and media_type together when a recurring monitor needs a consistent time range and content type.
- Deduplicate overlapping results with stable post IDs, shortcodes, or canonical URLs while retaining extra.hashtag for provenance.
- Handle media, counters, timestamps, and other public fields as optional because source availability can vary by post.
Related APIs
Use these APIs when you need a different type of public Instagram data.
- Instagram Followers Count API — Retrieve public profile identity and visible follower, following, and post counts.
- Instagram Posts API — Collect public posts, media, hashtags, mentions, timestamps, and engagement by username.
- Instagram Reels API — Collect public Reels, media, audio, hashtags, mentions, and engagement by username.
- Instagram Search API — Search public profiles by keyword or handle with identity and visible account signals.
- Instagram Comments API — Collect public comments, authors, timestamps, likes, and replies from post URLs.
- Instagram Profiles API — Retrieve public profile identity, biographies, links, account flags, categories, and visible counts by username.
- Instagram Followers List API — Collect public follower profile records with source-account and relationship context.
- Instagram Following List API — Collect public profiles followed by Instagram accounts with identity, relationship context, and visible account counts.
- Instagram Tagged Posts API — Collect public posts that tag selected profiles with authors, media, mentions, tagged-user context, and engagement.
- Instagram Transcript API — Extract transcript text, language, format, source URLs, and shortcodes from public post or Reel URLs.
- Instagram Audio Reels API — Collect public Reels by known numeric audio ID with captions, creators, media, timestamps, visible engagement, and source-audio context.
- Instagram Highlight Items API — Retrieve saved public Story items from known highlight IDs with text, author identity, media, timestamps, visible metrics, and source context.
- Instagram Post Info API — Look up known public post, Reel, or legacy IGTV URLs with captions, author identity, media, timestamps, visible engagement, and input context.
- Instagram Reels Search API — Search public Reels by text query with captions, creators, media, timestamps, visible engagement, and query context.
- Instagram Story Highlights API — List public Story Highlight containers by username with titles, owner context, media counts, and reusable highlight IDs.
- Instagram Trending Reels API — Capture the current public Reel set from the trending feed with captions, creators, media, timestamps, and visible engagement.