사용자 프로필 및 사용자 미디어 가져오기

이 가이드에서는 Instagram 사용자의 프로필과 미디어를 가져오는 방법을 설명합니다.

사용자 프로필 가져오기

다음의 단계를 따라 사용자에 대한 Instagram 사용자 프로필 데이터(필드)를 가져옵니다.

1단계: 액세스 토큰 및 권한 가져오기

액세스 토큰 및 권한 가져오기 가이드에 따라 사용자의 Instagram 사용자 액세스 토큰을 가져오세요. instagram_graph_user_profile 권한이 필요하므로 사용자로부터 인증을 가져올 때user_profile 범위를 요청하세요.

2단계: 사용자 노드 쿼리

다음 엔드포인트에 요청을 보냅니다.

GET /me?fields={fields}&access_token={access-token}

{fields}는 반환받고자 하는 사용자 필드의 쉼표로 구분된 리스트로 교체하고, {access-token}은 사용자의 액세스 토큰으로 교체합니다. GET /me 엔드포인트가 토큰에서 사용자 ID를 결정하고 사용자 노드로 리디렉션합니다.

요청 샘플

curl -X GET \
  'https://graph.instagram.com/me?fields=id,username&access_token=IGQVJ...'

응답 샘플

{
  "id": "17841405793187218",
  "username": "jayposiris"
}

사용자 미디어 가져오기

다음 단계에 따라 Instagram 사용자에 대한 미디어 컬렉션을 가져옵니다.

1단계: 액세스 토큰 및 권한 가져오기

액세스 토큰 및 권한 가져오기 가이드에 따라 사용자의 Instagram 사용자 액세스 토큰을 가져오세요. instagram_graph_user_profile 및 instagram_graph_user_media permissions 권한이 필요하므로 사용자로부터 인증을 가져올 때user_profile 및 user_media 범위를 요청하세요.

2단계: 사용자 미디어 에지 쿼리

다음 엔드포인트에 요청을 보냅니다.

GET /me/media?fields={fields}&access_token={access-token}

{fields}는 응답에 포함된 각 미디어에 대해 반환받고자 하는 미디어 필드의 쉼표로 구분된 리스트로 교체하고(또는 ID만 원할 경우 fields 매개변수를 완전히 생략), {access-token}은 사용자의 액세스 토큰으로 교체합니다. GET /me 엔드포인트가 토큰에서 사용자 ID를 결정하고 사용자 노드로 리디렉션합니다.

요청 샘플

curl -X GET \
  'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'

응답 샘플

{
  "data": [
    {
      "id": "17895695668004550",
      "caption": ""
    },
    {
      "id": "17899305451014820",
      "caption": ""
    },
    {
      "id": "17896450804038745",
      "caption": ""
    },
    {
      "id": "17881042411086627",
      "caption": ""
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "next": "https://graph.faceb..."
  }
}

미디어 데이터 가져오기

다음 단계에 따라 이미지, 동영상 또는 사진첩에 대한 데이터(필드)를 가져옵니다.

1단계: 액세스 토큰 및 권한 가져오기

액세스 토큰 및 권한 가져오기 가이드에 따라 사용자의 Instagram 사용자 액세스 토큰을 가져오세요. instagram_graph_user_media 권한이 필요하므로 사용자로부터 인증을 가져올 때user_media 범위를 요청하세요.

2단계: 미디어 노드 쿼리

다음 엔드포인트에 요청을 보냅니다.

GET /{media-id}?fields={fields}&access_token={access-token}

{media-id}는 쿼리하고자 하는 이미지, 동영상 또는 사진첩의 ID로 교체하고, {fields}는 반환받고자 하는 미디어 필드의 쉼표로 구분된 리스트로 교체하고, {access-token}은 사용자의 액세스 토큰으로 교체합니다.

요청 샘플

curl -X GET \
  'https://graph.instagram.com/17895695668004550?fields=id,media_type,media_url,username,timestamp&access_token=IGQVJ...'

응답 샘플

{
  "id": "17895695668004550",
  "media_type": "IMAGE",
  "media_url": "https://fb-s-b-a.akamaihd.net/...",
  "username": "jayposiris"
  "timestamp": "2017-08-31T18:10:00+0000"
}

2단계(대안): 사용자 미디어 에지 쿼리

사용자 미디어 에지를 쿼리하여 사용자에 대한 미디어의 컬렉션을 가져오고, 필드 확장 기능을 사용하여 응답에 해당 컬렉션의 각 미디어에 대한 미디어 필드를 포함할 수 있습니다. 이렇게 하려면 다음 엔드포인트에 요청을 보내세요.

GET /me/media?fields={fields}&access_token={access-token}

{fields}는 컬렉션의 각 미디어에 대해 반환받고자 하는 미디어 필드의 쉼표로 구분된 리스트로 교체하고, {access-token}은 사용자의 액세스 토큰으로 교체합니다. GET /me 엔드포인트가 토큰에서 사용자 ID를 결정하고 사용자 노드로 리디렉션합니다.

요청 샘플

curl -X GET \
  'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'

응답 샘플

{
  "data": [
    {
      "id": "17895695668004550",
      "caption": ""
    },
    {
      "id": "17899305451014820",
      "caption": ""
    },
    {
      "id": "17896450804038745",
      "caption": ""
    },
    {
      "id": "17881042411086627",
      "caption": ""
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "next": "https://graph.faceb..."
  }
}

사진첩 콘텐츠 가져오기

다음 단계에 따라 사진첩 미디어에 대한 이미지 및 동영상 미디어의 컬렉션을 가져옵니다.

1단계: 액세스 토큰 및 권한 가져오기

액세스 토큰 및 권한 가져오기 가이드에 따라 사용자의 Instagram 사용자 액세스 토큰을 가져오세요. instagram_graph_user_media 권한이 필요하므로 사용자로부터 인증을 가져올 때user_media 범위를 요청하세요.

2단계: 미디어 하위 요소 에지 쿼리

다음 엔드포인트에 요청을 보냅니다.

GET /{media-id}/children?fields={fields}&access_token={access-token}

{media-id}는 쿼리하고자 하는 사진첩 ID로 교체하고, {fields}는 컬렉션의 각 이미지 및 동영상 미디어에 대해 반환받고자 하는 미디어 필드의 쉼표로 구분된 리스트로 교체하고(또는 ID만 원하는 경우 fields 매개변수를 모두 생략), {access-token}은 사용자의 액세스 토큰으로 교체합니다.

요청 샘플

curl -X GET \
  'https://graph.instagram.com/17896450804038745/children?access_token=IGQVJ...'

응답 샘플

{
  "data": [
    {
      "id": "17880997618081620"
    },
    {
      "id": "17871527143187462"
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "previous": "https://graph.faceb...",
    "next": "https://graph.faceb..."
  }
}