만들기

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

읽기

GET /{ig-user-id}

Instagram 비즈니스 또는 크리에이터 계정에 대한 필드와 에지를 가져옵니다.

요구 사항

유형설명

액세스 토큰

사용자.

비즈니스 역할

제품 태그에 대해 shopping_product_tag_eligibility 필드를 요청할 경우 앱 사용자는 IG 사용자의 Instagram Shop을 소유하는 비즈니스 관리자에 대한 관리자 역할이 있어야 합니다.

Instagram Shop

제품 태그에 대해 shopping_product_tag_eligibility 필드를 요청할 경우 IG 사용자는 제품이 포함된 제품 카탈로그가 승인된 Instagram Shop이 있어야 합니다.

권한

instagram_basic
pages_read_engagement
pages_show_list


비즈니스 관리자를 통해 앱 사용자에게 페이지에 대한 역할을 부여한 경우 다음 중 하나도 필요합니다.


ads_management
business_management


제품 태그에 대해 shopping_product_tag_eligibility 필드를 요청하는 경우 다음도 필요합니다.


catalog_management
instagram_shopping_tag_products

요청 구문

GET https://graph.facebook.com/{api-version}/{ig-user-id}
  ?fields={fields}
  &access_token={access-token}

경로 매개변수

자리 표시자

{api-version}

API 버전

{ig-user-id}

필수 항목. IG 사용자 ID.

쿼리 문자열 매개변수

자리 표시자

access_token

{access-token}

필수 항목. 앱 사용자의 사용자 액세스 토큰입니다.

fields

{fields}

결과 세트에서 각 IG 사용자에 대해 반환하고자 하는 IG 사용자 필드의 쉼표로 구분된 리스트.

필드

전체 공개 필드는 필드 확장을 사용하여 에지로 반환될 수 있습니다.

필드 이름설명

biography
전체 공개

프로필 약력 텍스트.

id
전체 공개

앱 범위 사용자 ID.

ig_id

Instagram 사용자 ID. 기존 Instagram API와 사용했으나 지금은 사용 중단되었습니다. 대신 id를 사용하세요.

followers_count
전체 공개

사용자를 팔로우하는 Instagram 사용자 총수.

follows_count

사용자를 팔로우하는 Instagram 사용자 총수.

media_count
전체 공개

사용자에게 게시된 IG 미디어 총수.

name

프로필 이름.

profile_picture_url

프로필 사진 URL.

shopping_product_tag_eligibility

앱 사용자가 Instagram Shop을 설정해서 제품 태깅이 가능한 경우 true를 반환하고, 그렇지 않을 경우 false를 반환합니다.

username
전체 공개

프로필 사용자 이름.

website
전체 공개

단일 프로필 웹사이트 URL.

에지

에지설명

business_discovery

다른 Instagram 비즈니스 또는 Instagram 크리에이터 IG 사용자에 대한 데이터를 가져옵니다.

content_publishing_limit

IG 사용자의 현재 콘텐츠 게시 사용량을 나타냅니다.

insights

IG 사용자에 대한 소셜 상호작용 지표를 나타냅니다.

live_media

IG 사용자에 대한 라이브 방송 IG 미디어의 컬렉션을 나타냅니다.

media

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

media_publish

Instagram 비즈니스 IG 사용자에 대한 IG 컨테이너를 게시합니다.

mentions

IG 사용자가 다른 Instagram 사용자가 @언급한 IG 댓글이나 캡션이 있는 IG 미디어IG 댓글을 생성합니다.

mentioned_comment

다른 Instagram 사용자가 @언급한 IG 사용자에 대한 IG 댓글 데이터를 가져옵니다.

mentioned_media

다른 Instagram 사용자가 캡션에서 IG 사용자를 @언급한 IG 미디어 데이터를 가져옵니다.

recently_searched_hashtags

IG 사용자가 최근 7일 이내에 검색한 IG 해시태그를 가져옵니다.

stories

IG 사용자에 대한 스토리 IG 미디어 개체의 컬렉션을 나타냅니다.

tags

다른 Instagram 사용자가 IG 사용자를 태그한 IG 미디어의 컬렉션을 나타냅니다.

응답

기본 및 요청된 필드에지를 포함하는 JSON 형식의 개체입니다.

{
  "{field}":"{value}",
  ...
}

cURL 예시

요청

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405822304914?fields=biography%2Cid%2Cusername%2Cwebsite&access_token=EAACwX...'

응답

{
  "biography": "Dino data crunching app",
  "id": "17841405822304914",
  "username": "metricsaurus",
  "website": "http://www.metricsaurus.com/"
}

업데이트

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

삭제

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