Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Recherche par hashtag sur l'API Instagram : trouver des publications par hashtag

La recherche par hashtag d'Instagram trouve les photos et vidéos publics portant un hashtag, en deux appels. GET /ig_hashtag_search avec user_id et q renvoie l'ID du hashtag, puis GET /<HASHTAG_ID>/top_media liste les publications les plus populaires et /recent_media celles publiées au cours des dernières 24 heures. Un compte peut interroger 30 hashtags uniques sur une période glissante de 7 jours, avec Facebook Login ou Unified Login.

easyCoexistence connecte Instagram avec Instagram Login, pour que Claude, ChatGPT ou votre propre code travaille sur les publications, commentaires, mentions et statistiques du compte via l'API officielle de Meta, et ses commentaires et mentions peuvent être transmis à votre endpoint dès leur arrivée.

30

Hashtags uniques qu'un compte d'entreprise ou de créateur peut interroger sur une période glissante de 7 jours.

24 hours

recent_media ne renvoie que les médias publiés dans les 24 heures précédant la requête.

50

top_media renvoie le plus grand nombre de résultats par page et ne pagine qu'avec un curseur after.

Not supported

Dans la comparaison des trois configurations de Meta, la recherche par hashtag avec Instagram Login n'est pas prise en charge.

Static

Les identifiants de hashtags sont statiques et globaux : un hashtag garde le même ID pour chaque application et chaque utilisateur.

Comment fonctionne la recherche par hashtag ?

En deux étapes, effectuées au nom d'un compte Instagram d'entreprise ou de créateur, dont l'ID est transmis dans user_id. GET /ig_hashtag_search avec q défini sur le nom du hashtag renvoie son ID, que Meta présente comme statique et global, ce qui permet de le stocker. GET /<HASHTAG_ID>/top_media ou /recent_media, avec user_id et fields, liste ensuite les publications.

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

Quelle est la différence entre top_media et recent_media ?

top_media renvoie les photos et vidéos les plus populaires portant le hashtag, Meta jugeant la popularité d'après un mélange de vues et d'interactions des spectateurs. recent_media renvoie les plus récentes, limitées aux médias publiés dans les 24 heures précédant la requête, et Meta précise que ses réponses ne sont pas toujours dans l'ordre chronologique. Les deux ne renvoient que des médias publics, excluent les médias promus, boostés et publicitaires, et paginent les résultats 50 par 50 avec un curseur after.

Quels champs sont renvoyés ?

Les champs média que les références de Meta listent pour les deux edges, qui ne renvoient que des photos et vidéos publiques :

  • id, media_type (CAROUSEL_ALBUM, IMAGE ou VIDEO), permalink et timestamp.
  • caption et comments_count, ainsi que like_count, sauf si le propriétaire a masqué le nombre de J'aime.
  • children pour les médias en album, et media_url pour les autres médias, mais pas pour les vidéos dont l'audio est protégé par le droit d'auteur ou sous licence.
  • Pas de username : Meta ne l'autorise pas sur les médias renvoyés par la recherche par hashtag.

Quelles sont les limites ?

Meta les définit par compte et par hashtag :

  • 30 hashtags uniques sur 7 jours glissants. Un hashtag compte dès sa première requête ; le réinterroger dans ce délai est gratuit et ne relance pas ses 7 jours.
  • La récupération de top_media ou recent_media compte comme une requête sur le hashtag, même lorsque son ID est déjà stocké.
  • GET /<IG_ID>/recently_searched_hashtags liste les hashtags uniques que le compte a recherchés pendant la semaine en cours.
  • Les hashtags sur les Stories et les emojis dans les requêtes ne sont pas pris en charge, et les hashtags que Meta juge sensibles ou offensants renvoient une erreur générique.
  • Les médias trouvés ainsi ne peuvent pas être commentés via l'API.

Que faut-il pour la recherche par hashtag ?

L'approbation par App Review de la fonctionnalité Instagram Public Content Access et de l'autorisation instagram_basic, que Meta exige avant qu'une application puisse l'utiliser, ainsi qu'un token d'accès utilisateur issu de Facebook Login pour une personne pouvant effectuer des tâches sur la Page liée, ou un token Unified Login. La présentation générale de Meta indique que la recherche par hashtag n'est pas prise en charge avec Instagram Login, et ses appels relèvent des limites de débit de la plateforme de Meta plutôt que du budget d'appels par compte d'Instagram. Les usages autorisés listés par Meta incluent trouver les contenus de vos campagnes par hashtag, comprendre l'opinion publique sur votre marque et identifier les participants à un concours.

Peut-on rechercher des hashtags via easyCoexistence ?

easyCoexistence connecte Instagram avec Instagram Login, qui donne accès aux publications, commentaires, mentions et statistiques propres au compte connecté. Meta ne propose la recherche par hashtag qu'avec Facebook Login et Unified Login, donc elle sort du cadre de cette connexion. La connexion couvre à la place les publications du compte via list_social_posts, ainsi que ses commentaires et mentions, transmis à votre endpoint dès leur arrivée.

Erreurs courantes

  • Gaspiller le quota hebdomadaire en tests. Chaque nouveau hashtag compte dans les 30 sur 7 jours, et récupérer ses médias compte même avec un ID stocké.
  • Demander username sur les résultats de hashtags. Meta ne le renvoie pas pour les médias trouvés par la recherche par hashtag.
  • Lire recent_media comme une archive. Il couvre les médias publiés dans les 24 heures précédant la requête, et non strictement dans l'ordre chronologique.
  • Appeler avec un token Instagram Login. Meta indique que la recherche par hashtag n'est pas prise en charge dans cette configuration.
Faire cela avec EasyCoexistence

De US$ 9 à US$ 0,75 par connexion et par mois, en baisse à mesure que vous ajoutez des connexions, avec les 3 premiers jours en essai gratuit.

Questions fréquemment posées

L'API Instagram peut-elle rechercher des hashtags sans App Review ?

Non. Meta exige l'approbation par App Review de la fonctionnalité Instagram Public Content Access et de l'autorisation instagram_basic avant qu'une application puisse appeler la recherche par hashtag.

Puis-je savoir qui a publié avec un hashtag ?

Pas par nom d'utilisateur, que Meta omet dans les résultats de hashtags. Le permalink de chaque publication l'ouvre sur Instagram.

La recherche par hashtag inclut-elle les Stories ?

Non. Meta ne prend pas en charge les hashtags sur les Stories, et les deux edges ne renvoient que des photos et vidéos publiques.

Réinterroger le même hashtag compte-t-il deux fois ?

Non. Les requêtes répétées dans ses 7 jours ne comptent pas dans les 30 et ne relancent pas le minuteur du hashtag.

Poursuivre la lecture

Connectez votre premier canal en deux minutes.

Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.

  • 3 jours gratuits
  • Résiliable à tout moment
  • API officielles uniquement
  • Supervisé 24/7

Vérifié le