Skip to main content
POST
Instagram Hashtag Posts API

Instagram Hashtag Posts

Use with MCP

published_within accepts hour, day, week, month, or year; media_type accepts all or reels. results_limit defaults to 100, accepts values from 10 through 2,000, and applies to each hashtag.

Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
hashtags
string[]
required

Hashtags with or without the # prefix.

Minimum array length: 1
Minimum string length: 1
media_type
string
Minimum string length: 1
published_within
string
Minimum string length: 1
results_limit
integer
Required range: 10 <= x <= 2000

Response

Task accepted

code
integer
data
object