Search Instagram by keyword for profiles, Reels, hashtags, places, music, and exact-hashtag content. Get structured, deduplicated results with automatic pagination.
One or more search terms, one per line. What each term should be depends on the Search type below — Profiles: a username or account keyword, e.g. @openai. Top results: a keyword or phrase, e.g. hiring freelance developers. Reels: a video topic or phrase, e.g. AI video generator. Hashtags: a topic to discover hashtags for, e.g. travel photography. Places: a city, landmark or venue, e.g. Central Park. Music: a song, artist or music keyword, e.g. lofi beats. Hashtag posts: one exact hashtag with no spaces, e.g. #freelance — a phrase with spaces is rejected here, so use Top results or Reels for those. Duplicate terms are merged, and the run summary reports how many.
Type:string[]
Min. items:1
Search type
searchType
Required
Pick one search mode per run. Profiles — discover accounts for a username or keyword. Top results — the media Instagram surfaces for a keyword (mostly Reels, sometimes image or carousel posts). Reels — only the short videos for a keyword. Hashtags — which #tags relate to a keyword or topic. Hashtag posts — the posts inside one exact hashtag (the reliable way to reach image and carousel posts). Places — locations matching a keyword. Music — tracks matching a keyword. One type per run keeps the result set and the bill to one shape; run the Actor again for a second type.
Only applies when Search type is Profiles; every other search type ignores it, and the run summary says so. When on, each matched account is also read for its full public profile — biography, exact follower, following and post counts, business and category details, website, bio links, HD profile picture and highlight count — and written into the same row. A profile that cannot be read still returns its search row, marked as not enriched. Each successfully enriched account costs one extra charge on top of the per-result charge.
Type:boolean
Default:false
Results per search
maxResultsPerQueryType
Optional
How many results each search may deliver. 1–200, default 50. An upper bound, not a promise: a search that genuinely has fewer results returns fewer rather than being padded.
Type:integer
Minimum:1
Maximum:200
Default:50
Total results for this run
maxTotalResults
Optional
Hard ceiling for the whole run across all queries, 1–3000. When it is reached the remaining searches stop before they start, and the run summary lists them as not executed. A large batch can therefore be cut short by this limit before "Results per search" is filled.
Type:integer
Minimum:1
Maximum:3000
Default:1000
Hashtag posts tab (Hashtag posts only)
hashtagTab
Optional
Only applies when Search type is Hashtag posts; every other search type ignores this field, and the run summary says so when it happens. Top and Reels return one page that cannot be continued; Recent supports paging through older posts.