instagram/
hashtag-posts

Collectez les publications Instagram publiques d’un ou plusieurs hashtags, avec informations sur l’auteur, légendes, médias, hashtags sources, horodatages et indicateurs d’engagement visibles.

Instagram Hashtag Posts API

Découverte par hashtag
Enregistrements de publications
Filtres de période et de média
0,5 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

Instagram Hashtag Posts

Les publications d’un hashtag Instagram sont des photos ou des Reels publics associés à un hashtag recherché, avec légendes, identité du créateur, médias, horodatages et engagement visible. Ces signaux de contenu et de provenance servent à découvrir des sujets, comparer des hashtags, étudier des créateurs et surveiller une période donnée.

Fonctionnalités de la Instagram Hashtag Posts API

  • Collecte multi-hashtagsEnvoyez un ou plusieurs hashtags, avec ou sans #, results_limit s’appliquant séparément à chaque hashtag envoyé.
  • Filtres de période et de médiaLimitez la découverte à la dernière heure, au dernier jour, à la dernière semaine, au dernier mois ou à la dernière année, et choisissez toutes les publications ou les Reels uniquement.
  • Publications normaliséesRecevez dans une seule structure les ID de publication, shortcodes, URL canoniques, légendes, informations sur l’auteur, références de médias, hashtags, mentions et horodatages.
  • Contexte de la source et engagementConserve le hashtag envoyé qui a produit chaque enregistrement, avec les nombres de mentions J’aime, de commentaires, de vues et de lectures disponibles.

Paramètres de la Instagram Hashtag Posts API

ParamètresObligatoireDescription
hashtagsObligatoireUn ou plusieurs hashtags non vides, avec ou sans #, séparés par des virgules ou des retours à la ligne.
results_limitFacultatifNombre maximal d’enregistrements demandés par hashtag ; 100 par défaut, entiers de 10 à 2 000 acceptés.
published_withinFacultatifFenêtre de publication facultative : hour, day, week, month ou year.
media_typeFacultatifFiltre de contenu ; all inclut les types de publications pris en charge et reels restreint les résultats aux Reels.

Comment utiliser la Instagram Hashtag Posts API

Envoyez des hashtags sous forme de tâche asynchrone, interrogez son ID de tâche, puis lisez les publications normalisées avec la pagination par curseur.

  1. Préparez un ou plusieurs hashtags uniques, avec ou sans # initial.
  2. Envoyez hashtags et, facultativement, results_limit, published_within et media_type en POST à /v1/instagram/hashtag-posts.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
  4. Lisez /v1/tasks/{task_id}?limit=50 et suivez results.next_cursor tant que results.has_more vaut true.
curl -X POST "https://api.socq.ai/v1/instagram/hashtag-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtags":["travel","photography"],"results_limit":20,"published_within":"week","media_type":"all"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Cas d’usage de la Instagram Hashtag Posts API

  • Découverte de contenus par thème : Constituez des jeux de données consultables de publications publiques associées à des hashtags de campagne, d’événement, de communauté ou de secteur.
  • Comparaison entre hashtags : Comparez l’engagement visible et les formats de contenu tout en conservant le hashtag envoyé qui a produit chaque enregistrement.
  • Suivi des Reels récents : Combinez une fenêtre de publication avec le filtre Reels uniquement pour examiner les contenus courts d’actualité autour de hashtags choisis.
  • Enrichissement de créateurs et de contenus : Associez identité de la publication, contexte de l’auteur, légendes, médias et indicateurs visibles à vos fiches de recherche, de campagne ou de modération.

Conseils d’expert pour la Instagram Hashtag Posts API

  • Dédoublonnez les hashtags en entrée et gardez une seule graphie par sujet ; le collecteur traite chaque valeur envoyée indépendamment.
  • Prévoyez le volume par hashtag, car results_limit s’applique à chaque hashtag et non à la requête entière.
  • Utilisez published_within et media_type ensemble lorsqu’un suivi récurrent exige une période et un type de contenu constants.
  • Dédoublonnez les résultats qui se recoupent grâce aux ID de publication, shortcodes ou URL canoniques stables, en conservant extra.hashtag pour la provenance.
  • Traitez les médias, compteurs, horodatages et autres champs publics comme facultatifs, car leur disponibilité à la source peut varier d’une publication à l’autre.

En complément de la Instagram Hashtag Posts API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Instagram.

  • Instagram Search API — Recherchez des profils publics par mot-clé ou handle avec identité et signaux de compte visibles.
  • Instagram Comments API — Collectez les commentaires publics, auteurs, horodatages, mentions J’aime et réponses à partir d’URL de publications.
  • Instagram Profiles API — Récupérez par nom d’utilisateur l’identité publique d’un profil, ses biographies, liens, indicateurs de compte, catégories et nombres visibles.
  • Instagram Post Info API — Consultez des URL connues de publications, de Reels ou d’anciens IGTV publics avec légendes, identité de l’auteur, médias, horodatages, engagement visible et contexte de la saisie.
  • Instagram Reels Search API — Recherchez des Reels publics par requête textuelle avec légendes, créateurs, médias, horodatages, engagement visible et contexte de la requête.
  • Instagram Hashtag Search API — Trouvez les hashtags correspondant à un mot-clé, avec noms, ID, URL des pages de hashtag et nombre de publications publiques.

Explorer d’autres plateformes

Combinez les données Instagram avec les données publiques d’autres plateformes sociales prises en charge.

Instagram Hashtag Posts API — FAQ

Instagram Hashtag Posts API est une interface programmatique qui récupère les publications Instagram publiques associées à un ou plusieurs hashtags envoyés. Elle renvoie l’identité normalisée de la publication, les légendes, les auteurs, les médias, les horodatages, le contexte du hashtag source et les indicateurs d’engagement visibles.

Envoyez un tableau hashtags non vide ; les valeurs peuvent comporter ou non le # initial. results_limit accepte de 10 à 2 000, vaut 100 par défaut et s’applique séparément à chaque hashtag.

published_within accepte hour, day, week, month ou year. media_type accepte all ou reels, la valeur all étant utilisée lorsque le champ est omis.

Un résultat normalisé peut comprendre l’ID, le shortcode, l’URL, la légende, l’auteur, les médias, les hashtags, les mentions, created_at, collected_at, les nombres visibles de mentions J’aime, de commentaires, de vues et de lectures, ainsi que extra.hashtag pour l’entrée correspondante.

Chaque enregistrement normalisé renvoyé coûte 0,5 crédit, sans frais de base. L’estimation multiplie le results_limit de chaque hashtag par le nombre de hashtags envoyés, puis la consommation finale suit les enregistrements effectivement renvoyés.