Wyszukiwanie hashtagów w Instagram API: znajdowanie postów po hashtagu
Wyszukiwanie hashtagów w Instagramie znajduje publiczne zdjęcia i filmy z hashtagiem w dwóch wywołaniach. GET /ig_hashtag_search z user_id i q zwraca ID hashtagu, a GET /<HASHTAG_ID>/top_media wyświetla najpopularniejsze posty, a /recent_media te opublikowane w ciągu ostatnich 24 godzin. Konto może wykonać zapytanie o 30 unikalnych hashtagów w kroczącym okresie 7 dni, z logowaniem przez Facebook Login lub Unified Login.
easyCoexistence łączy Instagram przez Instagram Login, dzięki czemu Claude, ChatGPT lub Twój własny kod działa na własnych postach konta, komentarzach, wzmiankach i statystykach przez oficjalne API Meta.
Unikalne hashtagi, których jedno konto firmowe lub twórcy może użyć w kroczącym okresie 7 dni.
recent_media zwraca wyłącznie media opublikowane w ciągu 24 godzin od zapytania.
Najwięcej wyników na stronę zwraca top_media, która stronicuje tylko kursorem after.
Wyszukiwanie hashtagów w Instagram API z Instagram Login, według zestawienia Meta trzech konfiguracji.
Identyfikatory hashtagów są stałe i globalne: hashtag zachowuje ten sam ID dla każdej aplikacji i użytkownika.
Jak działa wyszukiwanie hashtagów?
W dwóch krokach, wykonywanych w imieniu konta firmowego lub twórcy Instagrama, którego ID przekazujesz w user_id. GET /ig_hashtag_search z parametrem q ustawionym na nazwę hashtagu zwraca jego ID, które według Meta jest stałe i globalne, więc można je zapisać. Następnie GET /<HASHTAG_ID>/top_media lub /recent_media, z parametrami user_id i fields, zwraca posty.
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_countCzym różni się top_media od recent_media?
top_media zwraca najpopularniejsze zdjęcia i filmy oznaczone hashtagiem; Meta ocenia popularność na podstawie mieszanki wyświetleń i interakcji widzów. recent_media zwraca najnowsze opublikowane media, ograniczone do tych opublikowanych w ciągu 24 godzin od zapytania, a Meta zaznacza, że jego odpowiedzi nie zawsze są w porządku chronologicznym. Obie zwracają wyłącznie publiczne media, pomijają media promowane, wzmacniane i reklamowe, a wyniki stronicują po 50, za pomocą kursora after.
Jakie pola są zwracane?
Pola mediów, które dokumentacja Meta wymienia dla obu endpointów, zwracających wyłącznie publiczne zdjęcia i filmy:
- id,
media_type(CAROUSEL_ALBUM, IMAGE lub VIDEO), permalink i timestamp. - caption i
comments_countorazlike_count, chyba że właściciel ukrył liczbę polubień. - children dla albumów oraz
media_urldla pozostałych mediów, ale nie dla filmów z objętą prawami autorskimi lub licencjonowaną ścieżką dźwiękową. - Bez username: Meta nie zezwala na to pole w mediach zwracanych przez wyszukiwanie hashtagów.
Jakie są limity?
Meta ustala je dla konta i dla hashtagu:
- 30 unikalnych hashtagów w kroczącym okresie 7 dni. Hashtag liczy się od pierwszego zapytania; ponowne zapytanie o niego w tym czasie jest bezpłatne i nie resetuje jego 7 dni.
- Pobranie
top_medialubrecent_medialiczy się jako zapytanie o hashtag, nawet gdy jego ID jest już zapisane. - GET /<
IG_ID>/recently_searched_hashtagszwraca listę unikalnych hashtagów, o które konto pytało w bieżącym tygodniu. - Hashtagi umieszczone w Stories i emotikony w zapytaniach nie są obsługiwane, a hashtagi, które Meta uznaje za wrażliwe lub obraźliwe, zwracają ogólny błąd.
- Media znalezione w ten sposób nie mogą być komentowane przez API.
Czego wymaga wyszukiwanie hashtagów?
Zatwierdzenia App Review dla funkcji Instagram Public Content Access oraz uprawnienia instagram_basic, których Meta wymaga, zanim aplikacja będzie mogła z niego korzystać, a także tokena dostępu użytkownika z Facebook Login dla osoby, która może wykonywać zadania na połączonej stronie, lub tokena Unified Login. Przegląd Meta wymienia wyszukiwanie hashtagów jako nieobsługiwane w Instagram Login, a jego wywołania podlegają limitom częstotliwości Platform Meta, a nie budżetowi wywołań na konto Instagrama. Dozwolone zastosowania, które wymienia Meta, to wyszukiwanie treści z kampanii hashtagowych, rozumienie publicznych opinii o marce oraz identyfikowanie uczestników konkursów.
Czy można wyszukiwać hashtagi przez easyCoexistence?
easyCoexistence łączy Instagram przez Instagram Login, który obejmuje własne posty połączonego konta, komentarze, wzmianki i statystyki. Meta oferuje wyszukiwanie hashtagów wyłącznie z Facebook Login i Unified Login, więc znajduje się ono poza tym połączeniem. Połączenie obejmuje zamiast tego: posty konta przez list_social_posts oraz jego komentarze i wzmianki, przekazywane na Twój endpoint w miarę ich napływania.
Typowe błędy
- Wyczerpanie tygodniowego limitu na testy. Każdy nowy hashtag liczy się do 30 na 7 dni, a pobranie jego mediów liczy się nawet przy zapisanym ID.
- Żądanie username w wynikach hashtagów. Meta go nie zwraca dla mediów znalezionych przez wyszukiwanie hashtagów.
- Traktowanie recent_media jak archiwum. Obejmuje media opublikowane w ciągu 24 godzin przed zapytaniem, i to nie w ścisłej kolejności chronologicznej.
- Wywołanie tokenem Instagram Login. Meta oznacza wyszukiwanie hashtagów jako nieobsługiwane w tej konfiguracji.
Komentarze i wzmianki mogą być przekazywane na Twój endpoint w miarę ich napływania. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z pierwszymi 3 dniami za darmo.
Najczęściej zadawane pytania
Czy API Instagrama może wyszukiwać hashtagi bez App Review?
Nie. Meta wymaga zatwierdzenia App Review dla funkcji Instagram Public Content Access oraz instagram_basic, zanim aplikacja będzie mogła wywołać wyszukiwanie hashtagów.
Czy mogę zobaczyć, kto opublikował post z hashtagiem?
Nie po nazwie użytkownika, którą Meta pomija w wynikach hashtagów. Permalink każdego posta otwiera go na Instagramie.
Czy wyszukiwanie hashtagów obejmuje Stories?
Nie. Meta nie obsługuje hashtagów w Stories, a obie endpointy zwracają wyłącznie publiczne zdjęcia i filmy.
Czy ponowne zapytanie o ten sam hashtag liczy się podwójnie?
Nie. Powtórne zapytania w ciągu jego 7 dni nie liczą się do 30 i nie resetują timera hashtagu.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w