Skip to main content
GET
search-hashtag
Returns hashtag, media_type, cursor and posts in the same normalised shape as get_instagram_reels_search: shortcode, url, caption, like_count, comment_count, video_play_count, video_view_count, owner, location and taken_at. The leading # is optional. media_type=reels narrows to reels; all returns posts and reels together.
cursor here is the next Google results page number, not an Instagram cursor.
Measured at about 78 KB for ten posts. To search caption keywords rather than a hashtag, use get_instagram_reels_search.

Example

First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.
Set this endpoint up in your agent →

Request contract

  • Method and path: GET /apis/v1/instagram/search/hashtag
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/instagram/search/hashtag
  • cursor: query; optional
  • date_posted: query; optional
  • hashtag: query; required
  • media_type: query; optional
  • Runtime facts: fdf0a203e7ec628291b62272da7b8bbbe431c8f77f251ea2e65c19cd3c98fa37
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Usage-based billing; Default request estimate: $0.00188 USD (not a fixed price). Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.00188
  • Cost contract: response_count
  • Published reference multiplier: 1.0
  • Settlement evidence source: response_body

Authorizations

Authorization
string
header
required

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

Query Parameters

cursor
string

The cursor returned by the previous response. In this version, it is the next Google results page number.

date_posted
enum<string>

Only return Google-indexed posts found in this relative window.

Available options:
last-day,
last-hour,
last-month,
last-week,
last-year
hashtag
string
required

The hashtag to search for. Include or omit the #.

media_type
enum<string>

Use all to search public posts and reels, or reels to only return reels. Defaults to all.

Available options:
all,
reels

Response

Successful response

credits_remaining
integer
cursor
string | null
hashtag
string
media_type
string
posts
object[]
success
boolean