Instagram hashtagzoek-API: posts vinden op hashtag
Met de hashtagzoekopdracht van Instagram vind je openbare foto's en video's met een hashtag, in twee aanroepen. GET /ig_hashtag_search met user_id en q geeft het ID van de hashtag terug. Daarna geeft GET /<HASHTAG_ID>/top_media de populairste posts terug en /recent_media de posts van de afgelopen 24 uur. Een account kan 30 unieke hashtags opvragen binnen een voortschrijdende periode van 7 dagen, met Facebook Login of Unified Login.
easyCoexistence verbindt Instagram met Instagram Login, zodat Claude, ChatGPT of je eigen code via de officiële API van Meta werkt met de eigen posts, reacties, vermeldingen en inzichten van het account.
Unieke hashtags die één zakelijk of creator-account kan opvragen in een voortschrijdende periode van 7 dagen.
recent_media geeft alleen media terug die binnen 24 uur voor de query zijn gepubliceerd.
Het grootste aantal resultaten per pagina komt van top_media, dat alleen met een after-cursor pagineert.
Hashtagzoeken met Instagram Login in de Instagram API, volgens de vergelijking van Meta tussen de drie opzetten.
Hashtag-ID's zijn statisch en globaal: een hashtag houdt per app en gebruiker hetzelfde ID.
Hoe werkt hashtagzoeken?
In twee stappen, uitgevoerd namens een zakelijk of creator-account van Instagram waarvan het ID in user_id staat. GET /ig_hashtag_search met q ingesteld op de naam van de hashtag geeft het ID terug. Meta zegt dat dit ID statisch en globaal is, dus het kan worden opgeslagen. Daarna geeft GET /<HASHTAG_ID>/top_media of /recent_media, met user_id en fields, de posts terug.
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_countWat is het verschil tussen top_media en recent_media?
top_media geeft de populairste foto's en video's met de hashtag terug; Meta bepaalt populariteit aan de hand van een mix van weergaven en interactie van kijkers. recent_media geeft de meest recent gepubliceerde media terug, beperkt tot media die binnen 24 uur voor de query zijn gepubliceerd. Meta merkt op dat de antwoorden niet altijd chronologisch zijn. Beide geven alleen openbare media terug, laten gesponsorde, geboostte en advertentiemedia weg en pagineren 50 per keer met een after-cursor.
Welke velden komen terug?
De mediavelden die Meta's referenties voor beide edges vermelden, die alleen openbare foto's en video's teruggeven:
- id,
media_type(CAROUSEL_ALBUM, IMAGE of VIDEO), permalink en timestamp. - caption en
comments_count, pluslike_counttenzij de eigenaar het aantal likes heeft verborgen. - children voor albummedia, en
media_urlvoor andere media, maar niet voor video's met auteursrechtelijk beschermde of gelicentieerde audio. - Geen username: Meta staat dat niet toe bij media die via hashtagzoeken worden gevonden.
Wat zijn de limieten?
Meta stelt ze per account en per hashtag:
- 30 unieke hashtags in een voortschrijdende periode van 7 dagen. Een hashtag telt mee vanaf de eerste query; opnieuw opvragen binnen die tijd is gratis en start de 7 dagen niet opnieuw.
- Het ophalen van
top_mediaofrecent_mediatelt als het opvragen van de hashtag, ook wanneer het ID al is opgeslagen. - GET /<
IG_ID>/recently_searched_hashtagstoont de unieke hashtags die het account deze week heeft doorzocht. - Hashtags in Stories en emoji's in query's worden niet ondersteund, en hashtags die Meta als gevoelig of aanstootgevend beschouwt, geven een algemene fout.
- Media die zo is gevonden, kan via de API niet van commentaar worden voorzien.
Wat heeft hashtagzoeken nodig?
Goedkeuring van App Review voor de functie Instagram Public Content Access en de permissie instagram_basic, die Meta vereist voordat een app dit kan gebruiken, en een gebruikerstoegangstoken van Facebook Login voor een persoon die taken kan uitvoeren op de gekoppelde Pagina, of een Unified Login-token. Meta's overzicht vermeldt hashtagzoeken als niet ondersteund met Instagram Login, en de aanroepen vallen onder de ratelimieten van het Meta-platform in plaats van onder het aanroepbudget per account van Instagram. De toegestane toepassingen die Meta noemt zijn het vinden van content uit je hashtagcampagnes, inzicht in het publieke sentiment over je merk en het identificeren van wedstrijdwinnaars.
Kun je via easyCoexistence hashtags doorzoeken?
easyCoexistence verbindt Instagram met Instagram Login, die de eigen posts, reacties, vermeldingen en inzichten van het gekoppelde account bereikt. Meta biedt hashtagzoeken alleen met Facebook Login en Unified Login aan, dus het valt buiten deze verbinding. Wat de verbinding wel dekt: de eigen posts van het account via list_social_posts, en de reacties en vermeldingen, doorgestuurd naar je endpoint zodra ze binnenkomen.
Veelgemaakte fouten
- Het wekelijkse quotum opmaken aan tests. Elke nieuwe hashtag telt mee voor de 30 per 7 dagen, en het ophalen van de media telt mee, zelfs met een opgeslagen ID.
- username opvragen bij hashtagresultaten. Meta geeft die niet terug voor media die via hashtagzoeken zijn gevonden.
- recent_media lezen als archief. Het dekt media die in de 24 uur voor de query zijn gepubliceerd, en niet in strikte chronologische volgorde.
- Aanroepen met een Instagram Login-token. Meta markeert hashtagzoeken in die opzet als niet ondersteund.
Reacties en vermeldingen kunnen naar je endpoint worden doorgestuurd zodra ze binnenkomen. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen gratis.
Veelgestelde vragen
Kan de Instagram API hashtags doorzoeken zonder App Review?
Nee. Meta vereist goedkeuring van App Review voor de functie Instagram Public Content Access en instagram_basic voordat een app hashtagzoeken kan aanroepen.
Kan ik zien wie met een hashtag heeft gepost?
Niet op gebruikersnaam, die Meta weglaat in hashtagresultaten. De permalink van elke post opent hem op Instagram.
Telt hashtagzoeken ook Stories mee?
Nee. Meta ondersteunt geen hashtags in Stories, en beide edges geven alleen openbare foto's en video's terug.
Telt het opnieuw opvragen van dezelfde hashtag dubbel?
Nee. Herhaalde query's binnen de 7 dagen tellen niet mee voor de 30 en starten de timer van de hashtag niet opnieuw.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op