Instagram hashtag search API: paghahanap ng posts ayon sa hashtag
Hinahanap ng hashtag search ng Instagram ang public na larawan at video na may hashtag, sa dalawang tawag. Ibinabalik ng GET /ig_hashtag_search na may user_id at q ang ID ng hashtag, pagkatapos ay inililista ng GET /<HASHTAG_ID>/top_media ang pinakasikat na posts, at ang /recent_media naman ay ang mga na-publish sa nakaraang 24 na oras. Maaaring mag-query ang isang account ng 30 natatanging hashtag sa rolling na 7 araw, gamit ang Facebook Login o Unified Login.
Ikinokonekta ng easyCoexistence ang Instagram gamit ang Instagram Login, kaya gumagana ang Claude, ChatGPT o sarili ninyong code sa sariling posts, comments, mentions at insights ng account sa pamamagitan ng opisyal na API ng Meta, at maaaring ipasa ang comments at mentions nito sa inyong endpoint habang dumarating ang mga ito.
Natatanging hashtag na maaaring i-query ng isang negosyo o creator account sa rolling na 7 araw.
Ang recent_media ay nagbabalik lamang ng media na na-publish sa loob ng 24 na oras mula sa query.
Pinakamaraming resulta kada page mula sa top_media, na nagpa-page lamang gamit ang after cursor.
Hashtag search gamit ang Instagram API sa Instagram Login, ayon sa paghahambing ng Meta sa tatlong setup.
Static at global ang hashtag ID: nananatili ang parehong ID para sa bawat app at user.
Paano gumagana ang hashtag search?
Sa dalawang hakbang, ginagawa sa ngalan ng isang Instagram na negosyo o creator account na ang ID ay nakalagay sa user_id. Ang GET /ig_hashtag_search na may q na nakatakda sa pangalan ng hashtag ay nagbabalik ng ID nito, na ayon sa Meta ay static at global kaya maaari itong i-store. Ang GET /<HASHTAG_ID>/top_media o /recent_media, kasama ang user_id at fields, ay naglilista ng posts.
GET /ig_hashtag_search?user_id=<IG_ID>&q=coffee
{ "data": [ { "id": "<HASHTAG_ID>" } ] }
GET /<HASHTAG_ID>/recent_media
?user_id=<IG_ID>
&fields=id,media_type,permalink,timestamp,like_count,comments_countAno ang pagkakaiba ng top_media at recent_media?
Ibinabalik ng top_media ang pinakasikat na larawan at video na may hashtag, kung saan sinusukat ng Meta ang popularidad gamit ang kombinasyon ng views at interaksyon ng mga nanonood. Ibinabalik naman ng recent_media ang pinakabagong na-publish, limitado sa media na na-publish sa loob ng 24 na oras mula sa query, at sinasabi ng Meta na hindi laging nasa pagkakasunod-sunod ayon sa oras ang mga sagot nito. Parehong public media lamang ang ibinabalik, hindi kasama ang promoted, boosted at ad media, at nagpa-page ng 50 resulta kada beses gamit ang after cursor.
Anong fields ang ibinabalik?
Ang media fields na nakalista sa mga reference ng Meta para sa parehong edge, na nagbabalik lamang ng public na larawan at video:
- id,
media_type(CAROUSEL_ALBUM, IMAGE o VIDEO), permalink at timestamp. - caption at
comments_count, patilike_countmaliban kung itinago ng may-ari ang bilang ng likes. - children para sa album media, at
media_urlpara sa iba pang media, pero hindi para sa video na may copyrighted o licensed na audio. - Hindi kasama ang username: hindi ito pinapayagan ng Meta sa media na ibinabalik ng hashtag search.
Ano ang mga limit?
Itinatakda ng Meta ang mga ito kada account at kada hashtag:
- 30 natatanging hashtag sa rolling na 7 araw. Nagsisimulang mabilang ang hashtag mula sa unang query nito; ang muling pag-query dito sa loob ng panahong iyon ay libre at hindi nire-restart ang 7 araw nito.
- Ang pag-fetch ng
top_mediaorecent_mediaay binibilang bilang pag-query ng hashtag, kahit nakastore na ang ID nito. - Ang GET /<
IG_ID>/recently_searched_hashtagsay naglilista ng mga natatanging hashtag na hinanap ng account sa kasalukuyang linggo. - Hindi suportado ang hashtags sa Stories at emojis sa query, at ang mga hashtag na itinuturing ng Meta na sensitibo o nakakasakit ay nagbabalik ng generic na error.
- Ang media na nahanap sa ganitong paraan ay hindi maaaring i-comment sa pamamagitan ng API.
Ano ang kailangan ng hashtag search?
Approval ng App Review para sa Instagram Public Content Access feature at sa instagram_basic permission, na kinakailangan ng Meta bago magamit ng app ito, at user access token mula sa Facebook Login para sa taong may kakayahang magsagawa ng tasks sa naka-link na Page, o Unified Login token. Ayon sa overview ng Meta, hindi suportado ang hashtag search sa Instagram Login, at ang mga tawag nito ay sakop ng Platform rate limit ng Meta at hindi ng per-account na call budget ng Instagram. Kabilang sa mga pinapayagang gamit na nakalista ng Meta ang paghahanap ng content mula sa inyong hashtag campaigns, pag-unawa sa pampublikong sentimyento tungkol sa inyong brand, at pagtukoy sa mga kalahok sa contest.
Maaari bang mag-search ng hashtag sa pamamagitan ng easyCoexistence?
Ikinokonekta ng easyCoexistence ang Instagram gamit ang Instagram Login, na umaabot sa sariling posts, comments, mentions at insights ng konektadong account. Nag-aalok ang Meta ng hashtag search gamit lamang ang Facebook Login at Unified Login, kaya hindi ito sakop ng koneksyong ito. Ang saklaw ng koneksyon sa halip: ang sariling posts ng account sa pamamagitan ng list_social_posts, at ang comments at mentions nito, na ipinapasa sa inyong endpoint habang dumarating ang mga ito.
Mga karaniwang pagkakamali
- Pag-ubos ng lingguhang quota sa mga test. Bawat bagong hashtag ay binibilang sa 30 kada 7 araw, at ang pag-fetch ng media nito ay binibilang kahit may nakastore na ID.
- Pag-request ng username sa resulta ng hashtag. Hindi ito ibinabalik ng Meta para sa media na nahanap sa pamamagitan ng hashtag search.
- Pagbasa sa recent_media bilang archive. Sakop lamang nito ang media na na-publish sa 24 na oras bago ang query, at hindi ito laging nasa mahigpit na pagkakasunod-sunod ayon sa oras.
- Pagtawag gamit ang Instagram Login token. Minarkahan ng Meta na hindi suportado ang hashtag search sa setup na iyon.
Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang nagdaragdag kayo ng koneksyon, at ang unang 3 araw ay libre.
Mga madalas itanong
Maaari bang mag-search ng hashtag sa Instagram API nang walang App Review?
Hindi. Kailangan ng Meta ang approval ng App Review para sa Instagram Public Content Access feature at instagram_basic bago matawag ng app ang hashtag search.
Makikita ko ba kung sino ang nag-post gamit ang isang hashtag?
Hindi sa pamamagitan ng username, na inaalis ng Meta sa resulta ng hashtag. Binubuksan ng permalink ng bawat post ang post sa Instagram.
Kasama ba sa hashtag search ang Stories?
Hindi. Hindi sinusuportahan ng Meta ang hashtags sa Stories, at parehong public na larawan at video lamang ang ibinabalik ng dalawang edge.
Binibilang ba nang dalawang beses ang pag-query ulit ng parehong hashtag?
Hindi. Ang mga paulit-ulit na query sa loob ng 7 araw nito ay hindi binibilang sa 30 at hindi nire-restart ang timer ng hashtag.
Magpatuloy sa pagbabasa
I-connect ang inyong unang channel sa loob ng dalawang minuto.
Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.
- 3 araw na libre
- Mag-cancel anumang oras
- Official API lang
- Minomonitor 24/7
Na-verify noong