Instagram-hashtag-haku API: julkaisujen etsiminen hashtagin perusteella
Instagramin hashtag-haku löytää hashtagin sisältävät julkiset kuvat ja videot kahdella pyynnöllä. GET /ig_hashtag_search -pyyntö, jossa on user_id ja q, palauttaa hashtagin tunnuksen. Sen jälkeen GET /<HASHTAG_ID>/top_media listaa suosituimmat julkaisut ja /recent_media viimeisen 24 tunnin aikana julkaistut. Tili voi hakea 30 uniikkia hashtagia liukuvan 7 päivän jakson aikana, ja haku vaatii Facebook Loginin tai Unified Loginin.
easyCoexistence yhdistää Instagramin Instagram Loginilla, jolloin Claude, ChatGPT tai oma koodisi toimii tilin omien julkaisujen, kommenttien, mainintojen ja tilastotietojen kanssa Metan virallisen API:n kautta.
Uniikit hashtagit, jotka yksi yritys- tai sisällöntuottajatili voi hakea liukuvan 7 päivän jakson aikana.
recent_media palauttaa vain kyselyä edeltäneiden 24 tunnin aikana julkaistun median.
top_media palauttaa sivulla eniten tuloksia, ja sivutus tehdään vain after-osoittimella.
Metan kolmen asetelman vertailussa hashtag-haku Instagram API:n kautta Instagram Loginilla.
Hashtag-tunnukset ovat staattisia ja globaaleja: hashtag säilyttää saman tunnuksen jokaisessa sovelluksessa ja käyttäjällä.
Miten hashtag-haku toimii?
Haku tehdään kahdessa vaiheessa Instagram-yritys- tai sisällöntuottajatilin puolesta, jonka ID annetaan user_id-kentässä. GET /ig_hashtag_search -pyyntö, jossa q on hashtagin nimi, palauttaa sen tunnuksen. Metan mukaan tunnus on staattinen ja globaali, joten sen voi tallentaa. Sen jälkeen GET /<HASHTAG_ID>/top_media tai /recent_media, jossa ovat user_id ja fields, listaa julkaisut.
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_countMitä eroa on top_media- ja recent_media-päätepisteillä?
top_media palauttaa hashtagilla merkityt suosituimmat kuvat ja videot. Meta arvioi suosiota katselukertojen ja katsojien vuorovaikutuksen yhdistelmällä. recent_media palauttaa viimeisimmin julkaistut, rajattuna kyselyä edeltäneiden 24 tunnin julkaisuihin. Metan mukaan vastaukset eivät aina ole aikajärjestyksessä. Molemmat palauttavat vain julkista mediaa, jättävät pois mainostetut, tehostetut ja mainosmediat, ja sivuttavat tuloksia 50 kerrallaan after-osoittimella.
Mitkä kentät palautuvat?
Media-kentät, jotka Metan viitteet listaavat molemmille päätepisteille. Ne palauttavat vain julkisia kuvia ja videoita:
- id,
media_type(CAROUSEL_ALBUM, IMAGE tai VIDEO), permalink ja timestamp. - caption ja
comments_countsekälike_count, ellei julkaisija ole piilottanut tykkäysmääriä. - children albumimedialle ja
media_urlmuulle medialle, mutta ei videoille, joissa on tekijänoikeudella suojattua tai lisensoitua ääntä. - Ei username-kenttää: Meta ei salli sitä hashtag-haun kautta löydetylle medialle.
Mitkä ovat rajat?
Meta asettaa ne tilikohtaisesti ja hashtagikohtaisesti:
- 30 uniikkia hashtagia liukuvan 7 päivän jakson aikana. Hashtag lasketaan ensimmäisestä kyselystä lähtien, ja sen uudelleen kysyminen tuona aikana ei kuluta kiintiötä eikä käynnistä sen 7 päivää uudelleen.
top_media- tairecent_media-tulosten haku lasketaan hashtagin kyselyksi, vaikka sen tunnus olisi jo tallennettu.- GET /<
IG_ID>/recently_searched_hashtagslistaa uniikit hashtagit, joita tili on hakenut kuluvalla viikolla. - Storyssa olevat hashtagit ja emojit eivät ole tuettuja kyselyissä, ja Metan arkaluonteisiksi tai loukkaaviksi katsomat hashtagit palauttavat yleisen virheen.
- Tällä tavalla löydettyyn mediaan ei voi kommentoida API:n kautta.
Mitä hashtag-haku vaatii?
App Review -hyväksynnän Instagram Public Content Access -ominaisuudelle ja instagram_basic-oikeudelle, jotka Meta vaatii ennen kuin sovellus voi käyttää sitä, sekä käyttäjän käyttöoikeustunnuksen Facebook Loginilla henkilölle, joka voi tehdä tehtäviä yhdistetyllä sivulla, tai Unified Login -tunnuksen. Metan yleiskatsauksessa hashtag-haku ei ole tuettu Instagram Loginilla, ja sen pyynnöt kuuluvat Metan Platform-nopeusrajoituksiin eikä Instagramin tilikohtaiseen pyyntöbudjettiin. Metan luettelemat sallitut käyttötarkoitukset ovat muun muassa hashtag-kampanjoidesi sisällön löytäminen, julkisen mielipiteen ymmärtäminen brändistäsi sekä kilpailuun osallistujien tunnistaminen.
Voiko hashtageja hakea easyCoexistencen kautta?
easyCoexistence yhdistää Instagramin Instagram Loginilla, joka tavoittaa yhdistetyn tilin omat julkaisut, kommentit, maininnat ja tilastotiedot. Meta tarjoaa hashtag-haun vain Facebook Loginilla ja Unified Loginilla, joten se jää tämän yhteyden ulkopuolelle. Yhteys kattaa sen sijaan tilin omat julkaisut list_social_posts-työkalun kautta sekä kommentit ja maininnat, jotka välitetään endpointiisi niiden saapuessa.
Yleiset virheet
- Viikkokiintiön kuluttaminen testeihin. Jokainen uusi hashtag lasketaan 30 hashtagin kiintiöön 7 päivän aikana, ja sen median haku lasketaan mukaan, vaikka tunnus olisi tallennettu.
- username-kentän pyytäminen hashtag-tuloksissa. Meta ei palauta sitä hashtag-haun kautta löydetylle medialle.
- recent_media-päätepisteen lukeminen arkistona. Se kattaa kyselyä edeltävien 24 tunnin aikana julkaistun median, eikä se ole tiukasti aikajärjestyksessä.
- Pyyntö Instagram Login -tunnuksella. Meta merkitsee hashtag-haun ei-tuetuksi tuossa asetelmassa.
Kommentit ja maininnat voidaan välittää endpointiisi niiden saapuessa. Hinta alkaen US$ 9 yhteydeltä kuukaudessa, laskien US$ 0,75:een yhteyksien lisääntyessä, ja ensimmäiset 3 päivää ovat ilmaisia.
Usein kysytyt kysymykset
Voiko Instagram API hakea hashtageja ilman App Reviewta?
Ei. Meta vaatii App Review -hyväksynnän Instagram Public Content Access -ominaisuudelle ja instagram_basicille, ennen kuin sovellus voi kutsua hashtag-hakua.
Voinko nähdä, kuka on julkaissut hashtagilla?
Ei käyttäjänimen perusteella, koska Meta jättää sen hashtag-tuloksista pois. Jokaisen julkaisun permalink avaa sen Instagramissa.
Sisältyykö hashtag-hakuun Storyt?
Ei. Meta ei tue hashtageja Storyissa, ja molemmat päätepisteet palauttavat vain julkisia kuvia ja videoita.
Lasketaanko saman hashtagin uudelleen kysyminen kahdesti?
Ei. Toistuvat kyselyt 7 päivän sisällä eivät kulu 30 hashtagin kiintiöstä eivätkä käynnistä hashtagin ajastinta uudelleen.
Lue lisää
Yhdistä ensimmäinen kanavasi kahdessa minuutissa.
Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.
- 3 päivää ilmaiseksi
- Peruuta milloin tahansa
- Vain viralliset API:t
- Valvottu 24/7
Vahvistettu