API Instagram

L'API Instagram permet de consulter les profils utilisateurs, lister les publications, les reels et les médias tagués, lire les stories, obtenir les détails d'une publication, lire les commentaires et réponses, rechercher des utilisateurs et des hashtags, et parcourir le graphe social (abonnés / abonnements). Douze points d'accès, tous à 2 crédits par requête.

Points d'accès

Authentification

Chaque réponse réussie inclut des champs de suivi des crédits : credits_used, credits_remaining, et response_time (ms).

Identifier un utilisateur

Les points d'accès utilisateur acceptent soit un username soit un user_id numérique. Passer username est l'option la plus simple ; il est automatiquement résolu en user_id. Pour les appels répétés, lisez data.user.id dans la réponse du profil et passez-le comme user_id pour éviter la recherche.

Profil utilisateur

POST https://api.scavio.dev/api/v1/instagram/profile

Obtenez un profil utilisateur Instagram. Passez soit username soit user_id.

Corps de la requête

Exemple

curl -X POST 'https://api.scavio.dev/api/v1/instagram/profile' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"username": "instagram"}'

Champs de réponse (data.user)

Exemple de réponse

{
  "data": {
    "user": {
      "id": "25025320",
      "username": "instagram",
      "full_name": "Instagram",
      "biography": "Découvrez la suite sur Instagram",
      "is_verified": true,
      "is_private": false,
      "edge_followed_by": { "count": 672000000 },
      "edge_follow": { "count": 250 },
      "edge_owner_to_timeline_media": { "count": 7600 }
    }
  },
  "response_time": 845,
  "credits_used": 2,
  "credits_remaining": 11750
}

Publications de l'utilisateur

POST https://api.scavio.dev/api/v1/instagram/user/posts

Lister les publications d'un utilisateur (médias du fil). Passez username ou user_id.

Corps de la requête

Pagination

Utilisez data.page_info.end_cursor comme cursor dans la requête suivante. Arrêtez-vous quand data.page_info.has_next_page est false.

Reels de l'utilisateur (/api/v1/instagram/user/reels) et Publications taguées (/api/v1/instagram/user/tagged) prennent les mêmes paramètres et la même pagination que les publications de l'utilisateur, retournant respectivement les reels et les médias tagués.

Stories de l'utilisateur

POST https://api.scavio.dev/api/v1/instagram/user/stories

Obtenez les stories actuellement actives d'un utilisateur. Passez username ou user_id. Retourne les URLs des médias, le type (image/vidéo) et l'horodatage de chaque story.

Détails d'une publication

POST https://api.scavio.dev/api/v1/instagram/post

Obtenez les détails complets d'une publication ou d'un reel. Passez un de url, media_id, ou shortcode.

Corps de la requête

Exemple

curl -X POST 'https://api.scavio.dev/api/v1/instagram/post' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"shortcode": "DUajw4YkorV"}'

Commentaires d'une publication

POST https://api.scavio.dev/api/v1/instagram/post/comments

Obtenez les commentaires sur une publication. Passez soit un shortcode soit une url de publication.

Corps de la requête

Pagination

Utilisez data.next_min_id comme prochain cursor. Arrêtez-vous quand il est absent. Chaque commentaire expose un champ pk ; utilisez-le comme comment_id pour le point d'accès des réponses.

Réponses aux commentaires

POST https://api.scavio.dev/api/v1/instagram/post/comments/replies

Obtenez les réponses à un commentaire spécifique.

Corps de la requête

Recherche d'utilisateurs

POST https://api.scavio.dev/api/v1/instagram/search/users

Recherchez des utilisateurs Instagram par mot-clé.

Corps de la requête

Recherche de hashtags (/api/v1/instagram/search/hashtags) prend les mêmes paramètres et retourne les hashtags correspondants avec leur nombre de médias.

Abonnés d'un utilisateur

POST https://api.scavio.dev/api/v1/instagram/user/followers

Obtenez la liste des abonnés d'un utilisateur. Passez username ou user_id.

Corps de la requête

Abonnements d'un utilisateur

POST https://api.scavio.dev/api/v1/instagram/user/followings

Obtenez les comptes qu'un utilisateur suit. Même forme de requête et mêmes paramètres que pour les abonnés.

Référence de pagination

Remarques

• Chaque point d'accès coûte 2 crédits par requête.
• Les points d'accès utilisateur acceptent un username ou un user_id numérique ; le point d'accès publication accepte une url, media_id, ou shortcode.
• Les listes d'abonnés et d'abonnements ne peuvent être paginées que pour les comptes qu'Instagram le permet. Les grands comptes ou vérifiés retournent should_limit_list_of_followers: true, has_more: false, et aucun next_max_id -- c'est une restriction d'Instagram, pas une erreur. Testez la pagination avec un compte plus petit et non vérifié.
• Voir Erreurs pour la gestion des 401, 429, et 502.