사용자 미디어

On September 4, 2024, we announced the deprecation of the Instagram Basic Display API.

Starting December 4, 2024, all requests to the Instagram Basic Display API will return an error message. We recommend that you migrate your app to the Instagram API to avoid any disruption to your services.

Visit our News for Developers blog post to learn more.

사용자에 대한 미디어의 컬렉션을 나타냅니다.

만들기

지원되지 않는 작업입니다.

읽기

GET /{user-id}/media

사용자에 대한 미디어의 컬렉션을 가져옵니다.

제한 사항

스토리는 지원되지 않습니다.
홍보 게시물의 미디어는 지원되지 않습니다.
가장 최근 생성된 미디어를 최대 10,000개까지 반환합니다.

요구 사항

유형	요구 사항
액세스 토큰	Instagram 사용자
권한	`instagram_graph_user_media`, `instagram_graph_user_profile`

요청 구문

GET https://graph.instagram.com/{api-version}/{user-id}/media
  ?access_token={access-token}

경로 매개변수

자리 표시자	값
`{api-version}` 문자열	API 버전.
`{user-id}` 필수 문자열	앱 사용자의 앱 범위 사용자 ID(버전 11.0+) 또는 원시 사용자 ID(모든 버전).

쿼리 문자열 매개변수

요청을 보강하기 위해 다음 쿼리 문자열 매개변수를 포함합니다.

키	값
`access_token` 필수 문자열	앱 사용자의 Instagram 사용자 액세스 토큰입니다.
`fields` 쉼표로 구분된 리스트	결과 세트에서 각 미디어 노드에 대해 필드 확장에서 반환할 미디어 필드의 쉼표로 구분된 리스트.
`since` 타임스탬프	Unix 타임스탬프 또는 시간 기반 데이터 범위의 시작을 가리키는 `strtotime` 데이터 값. 시간 기반 페이지 매김을 참조하세요.
`until` 타임스탬프	Unix 타임스탬프 또는 시간 기반 데이터 범위의 끝을 가리키는 `strtotime` 데이터 값. 시간 기반 페이지 매김을 참조하세요.

응답

요청한 데이터가 포함된 JSON 형식의 개체.

{
  "data": [],
  "paging": {}
}

응답 내용

속성	값
`data`	사용자에 대한 미디어의 배열.
`paging`	페이지 매김 커서와 다음/이전 데이터 세트 검색 URL이 포함된 개체.

cURL 예시

요청

curl -X GET \
  'https://graph.instagram.com/v21.0/10218560180051171/media?access_token=IGQVJ...'

응답

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

업데이트

지원되지 않는 작업입니다.

삭제

지원되지 않는 작업입니다.