API de Instagram

La API de Instagram te permite consultar perfiles de usuario, listar publicaciones, reels y contenido etiquetado, leer historias, obtener detalles de publicaciones, leer comentarios y respuestas, buscar usuarios y hashtags, y navegar por el grafo social (seguidores / seguidos). Doce endpoints, todos a 2 créditos por solicitud.

Endpoints

Autenticación

Cada respuesta exitosa incluye campos de seguimiento de créditos: credits_used, credits_remaining y response_time (ms).

Identificar un usuario

Los endpoints de usuario aceptan ya sea un username o un user_id numérico. Pasar username es la opción más simple; se resuelve automáticamente a un user_id. Para llamadas repetidas, lea data.user.id de la respuesta del perfil y pase como user_id para omitir la búsqueda.

Perfil de usuario

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

Obtener un perfil de usuario de Instagram. Pase ya sea username o user_id.

Cuerpo de la solicitud

Ejemplo

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"}'

Campos de respuesta (data.user)

Respuesta de ejemplo

{
  "data": {
    "user": {
      "id": "25025320",
      "username": "instagram",
      "full_name": "Instagram",
      "biography": "Discover what's next on 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
}

Publicaciones del usuario

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

Listar publicaciones de un usuario (medios de línea de tiempo). Pase username o user_id.

Cuerpo de la solicitud

Paginación

Use data.page_info.end_cursor como cursor en la siguiente solicitud. Deténgase cuando data.page_info.has_next_page sea false.

Reels del usuario (/api/v1/instagram/user/reels) y Publicaciones etiquetadas (/api/v1/instagram/user/tagged) toman los mismos parámetros y paginación que Publicaciones del usuario, devolviendo reels y medios etiquetados respectivamente.

Historias del usuario

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

Obtener las historias activas actuales de un usuario. Pase username o user_id. Devuelve las URLs de los medios, el tipo (imagen/video) y la marca de tiempo de cada historia.

Detalles de publicación

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

Obtener detalles completos de una sola publicación o reel. Pase uno de url, media_id o shortcode.

Cuerpo de la solicitud

Ejemplo

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"}'

Comentarios de publicación

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

Obtener comentarios en una publicación. Pase ya sea un shortcode o una url de publicación.

Cuerpo de la solicitud

Paginación

Use data.next_min_id como el próximo cursor. Deténgase cuando esté ausente. Cada comentario expone un campo pk; úselo como comment_id para el endpoint de respuestas.

Respuestas a comentarios

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

Obtener respuestas a un comentario específico.

Cuerpo de la solicitud

Buscar usuarios

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

Buscar usuarios de Instagram por palabra clave.

Cuerpo de la solicitud

Buscar hashtags (/api/v1/instagram/search/hashtags) toma los mismos parámetros y devuelve hashtags coincidentes con sus conteos de medios.

Seguidores del usuario

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

Obtener la lista de seguidores de un usuario. Pase username o user_id.

Cuerpo de la solicitud

Usuarios seguidos

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

Obtener cuentas que un usuario sigue. Misma forma de solicitud y parámetros que seguidores.

Referencia de paginación

Notas

• Cada endpoint cuesta 2 créditos por solicitud.
• Los endpoints de usuario aceptan un username o un user_id numérico; el endpoint de publicación acepta una url, media_id o shortcode.
• Las listas de seguidores y seguidos solo son paginables para cuentas que Instagram lo permita. Las cuentas grandes o verificadas devuelven should_limit_list_of_followers: true, has_more: false y sin next_max_id -- esto es una restricción de Instagram, no un error. Pruebe la paginación con una cuenta más pequeña y no verificada.
• Consulte Errores para el manejo de 401, 429 y 502.