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ètres | Obligatoire | Description |
|---|---|---|
hashtags | Obligatoire | Un ou plusieurs hashtags non vides, avec ou sans #, séparés par des virgules ou des retours à la ligne. |
results_limit | Facultatif | Nombre maximal d’enregistrements demandés par hashtag ; 100 par défaut, entiers de 10 à 2 000 acceptés. |
published_within | Facultatif | Fenêtre de publication facultative : hour, day, week, month ou year. |
media_type | Facultatif | Filtre 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.
- Préparez un ou plusieurs hashtags uniques, avec ou sans # initial.
- Envoyez hashtags et, facultativement, results_limit, published_within et media_type en POST à /v1/instagram/hashtag-posts.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
- 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 trueCas 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.
API associées
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.
- Instagram Followers Count API
- Instagram Posts API
- Instagram Reels API
- Instagram Followers List API
- Instagram Following List API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Account Age Checker API