Instagram Location Posts
Les publications d’un lieu sont les photos et les Reels que les internautes associent à un endroit, d’un petit café de quartier à un stade un soir de match, chacun avec une légende, un auteur, des mentions J’aime, des commentaires et des médias. Les suivre montre ce que l’on partage depuis un lieu au moment où cela se produit, ce qui aide à étudier les tendances locales, à couvrir un événement et à trouver les créateurs qui publient depuis un endroit précis.
Fonctionnalités de la Instagram Location Posts API
- Publications d’un seul lieuFournissez un location_id ou un lien de page de lieu pour obtenir les publications et Reels publics qui y sont associés.
- Populaires ou récentessort_by à top renvoie les publications qu’Instagram classe le plus haut pour le lieu, tandis que recent renvoie d’abord les plus récentes et continue jusqu’à results_limit.
- La publication en entierChaque publication comprend son shortcode, son lien, sa légende, son auteur, ses nombres de mentions J’aime et de commentaires, son heure de publication et ses médias image ou vidéo, avec chaque diapositive d’un carrousel listée.
- Le lieu voyage avec la publicationextra.location_id et extra.location_name gardent le lieu rattaché à chaque enregistrement, ce qui aide lorsque vous combinez plusieurs lieux.
Paramètres de la Instagram Location Posts API
| Paramètres | Obligatoire | Description |
|---|---|---|
location_id | Obligatoire (au moins un) | ID numérique du lieu dont vous voulez les publications associées. Utilisez ce paramètre ou url. |
url | Obligatoire (au moins un) | Lien de la page du lieu, par exemple https://www.instagram.com/explore/locations/212988663/. Utilisez ce paramètre ou location_id. |
sort_by | Facultatif | top pour les publications les mieux classées du lieu (valeur par défaut), ou recent pour les plus récentes d’abord. |
results_limit | Facultatif | Nombre de publications à renvoyer, de 1 à 100. 20 par défaut. |
Comment utiliser la Instagram Location Posts API
Choisissez un lieu et un ordre, lancez la tâche, puis lisez les publications.
- Trouvez l’ID du lieu avec Instagram Location Search, ou copiez le lien de la page du lieu.
- Envoyez location_id, un sort_by valant top ou recent, et un results_limit en POST à /v1/instagram/location-posts.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez les publications dans results.items et suivez results.next_cursor pour obtenir la suite.
curl -X POST "https://api.socq.ai/v1/instagram/location-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"location_id":"384695225271379","sort_by":"top","results_limit":20}'
# Switch sort_by to "recent" for the newest posts first.
# The posts are returned by GET /v1/tasks/{task_id}.Cas d’usage de la Instagram Location Posts API
- Couverture d’événements : Collectez les publications récentes d’un stade, d’une salle de concert ou d’un site de festival pendant l’événement afin de réunir photos, légendes et réactions.
- Repérage des tendances locales : Passez en revue les légendes et médias récents d’un quartier ou d’un monument pour voir de quoi l’on parle sur place cette semaine.
- Identification de créateurs locaux : Servez-vous des auteurs des publications les mieux classées d’un lieu pour dresser la liste des créateurs qui publient depuis cet endroit.
Conseils d’expert pour la Instagram Location Posts API
- Utilisez sort_by recent lorsqu’un simple aperçu ne suffit pas ; il parcourt autant de publications que results_limit le permet.
- Planifiez des exécutions recent et conservez les ID de publications déjà vus, afin que chaque exécution n’ajoute que les nouvelles publications.
- Transmettez les URL de publications intéressantes à Instagram Comments ou à Instagram Post Likers pour voir la conversation et l’audience qui les entourent.
API associées
En complément de la Instagram Location Posts API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Instagram.
- Instagram Posts API — Collectez les publications publiques, médias, hashtags, mentions, horodatages et l’engagement par nom d’utilisateur.
- Instagram Reels API — Collectez par nom d’utilisateur les Reels publics, médias, audio, hashtags, mentions et l’engagement.
- Instagram Comments API — Collectez les commentaires publics, auteurs, horodatages, mentions J’aime et réponses à partir d’URL de publications.
- 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 Post Likers API — Listez les comptes de la liste visible des personnes ayant aimé une publication à partir de son URL, avec noms d’utilisateur, noms, avatars et statut de vérification.
- Instagram Location Info API — Consultez un lieu à partir de son ID ou de l’URL de sa page, avec nom, catégorie, téléphone, coordonnées et nombre de publications identifiées.
- Instagram Followers Count API
- Instagram Search API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API