Hashtag Search - Instagram Platform - Meta for Developers

Hashtag Search. Find public IG Media that has been tagged with specific hashtags. Limitations. You can query a maximum of 30 ... InstagramPlatformInstagramGraphAPIInstagramBasicDisplayAPISharingtoFeedSharingtoStoriesoEmbedoEmbed(Legacy)EmbedButtonHashtagSearch FindpublicIGMediathathasbeentaggedwithspecifichashtags. Limitations Youcanqueryamaximumof30uniquehashtagsonbehalfofanInstagramBusinessorCreatorAccountwithinarolling,7dayperiod.Onceyouqueryahashtag,itwillcountagainstthislimitfor7days.Subsequentqueriesonthesamehashtagwithinthistimeframewillnotcountagainstyourlimit,andwillnotresetitsinitialquery7daytimer. Personallyidentifiableinformationwillnotbeincludedinresponses. YoucannotcommentonhashtaggedmediaobjectsdiscoveredthroughtheAPI. HashtagsonStoriesarenotsupported. Emojisinhashtagqueriesarenotsupported. TheAPIwillreturnagenericerrorforanyrequeststhatincludehashtagsthatwehavedeemedsensitiveoroffensive. Requirements InordertousethisAPI,youmustundergoAppReviewandrequestapprovalfor: theInstagramPublicContentAccessfeature theinstagram_basicpermission Endpoints TheHashtagSearchAPIconsistsofthefollowingnodesandedges: GET/ig_hashtag_search—togetaspecifichashtag'snodeID GET/{ig-hashtag-id}—togetdataaboutahashtag GET/{ig-hashtag-id}/top_media—togetthemostpopularphotosandvideosthathaveaspecifichashtag GET/{ig-hashtag-id}/recent_media—togetthemostrecentlypublishedphotosandvideosthathaveaspecifichashtag GET/{ig-user-id}/recently_searched_hashtags—todeterminetheuniquehashtagsanInstagramBusinessorCreatorAccounthassearchedforinthecurrentweek Refertoeachendpoint'sreferencedocumentationforsupportedfields,parameters,andusagerequirements. CommonUses GettingMediaTaggedWithAHashtag Togetallofthephotosandvideosthathaveaspecifichashtag,firstusethe/ig_hashtag_searchendpointandincludethehashtagandIDoftheInstagramBusinessorCreatorAccountmakingthequery.Forexample,ifthequeryisbeingmadeonbehalfoftheInstagramBusinessAccountwiththeID17841405309211844,youcouldgettheIDforthe"#coke"hashtagbyperformingthefollowingquery: GETgraph.facebook.com/ig_hashtag_search ?user_id=17841405309211844 &q=cokeThiswillreturntheIDforthe“#Coke”hashtagnode: { "id":"17873440459141021" }NowthatyouhavethehashtagID(17873440459141021),youcanqueryits/top_mediaor/recent_mediaedgeandincludetheBusinessAccountIDtogetacollectionofmediaobjectsthathavethe“#coke”hashtag.Forexample: GETgraph.facebook.com/17873440459141021/recent_media ?user_id=17841405309211844Thiswouldreturnaresponsethatlookslikethis: { "data":[ { "id":"17880997618081620" }, { "id":"17871527143187462" }, { "id":"17896450804038745" } ] }