Skip to documentation
Browse documentation

Search Hashtag Posts

Discovers public indexed posts and reels for a hashtag with media-type and date filters.

Capability ID instagram.hashtag-posts.search
Cost 1 credit per request
Maximum runtime 120 seconds
View raw

POST /execute Shared execution endpoint

Input parameters

date_posted string optional

Date posted supplied for this request. Allowed values: `any`, `day`, `week`, `month`, `year`.

Example any
Available values anydayweekmonthyear
enrich boolean optional

Enrich supplied for this request.

Example false
hashtag string required

Hashtag supplied for this request.

Example india
limit integer optional

Maximum number of results to return.

Example 10
max_pages integer optional

Max pages supplied for this request.

Example 2
media_type string optional

Media type supplied for this request. Allowed values: `all`, `posts`, `reels`.

Example all
Available values allpostsreels
page integer optional

One-based result page to fetch.

Response

Successful output is returned in results[0].data. Raw platform output is intentionally open-ended and may evolve with the upstream source.

Illustrative sample The full redacted fixture is shown in the response panel.

Illustrative output fields

Derived from the sample above for orientation only. These observed fields are not a fixed response schema.

PathObserved typeExample
has_more boolean false
hashtag string india
match_mode string keyword_popular
next_page integer 3
pages integer 2
results array 3 items
results array 3 items
total_count integer 10

Execution behavior

A 200 response completed inline. A 202 response was queued; poll GET /jobs/:id until the job reaches completed or failed.