Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

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.

30

Unikalne hashtagi, których jedno konto firmowe lub twórcy może użyć w kroczącym okresie 7 dni.

24 hours

recent_media zwraca wyłącznie media opublikowane w ciągu 24 godzin od zapytania.

50

Najwięcej wyników na stronę zwraca top_media, która stronicuje tylko kursorem after.

Not supported

Wyszukiwanie hashtagów w Instagram API z Instagram Login, według zestawienia Meta trzech konfiguracji.

Static

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.

Finding a hashtag's ID, then its recent 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_count

Czym 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_count oraz like_count, chyba że właściciel ukrył liczbę polubień.
  • children dla albumów oraz media_url dla 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_media lub recent_media liczy się jako zapytanie o hashtag, nawet gdy jego ID jest już zapisane.
  • GET /<IG_ID>/recently_searched_hashtags zwraca 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.
Z EasyCoexistence zrobisz to

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