Instagram API 연동 가이드
Instagram Graph API · 약 25분 소요
사전 준비 사항
- Instagram 비즈니스 또는 크리에이터 계정 (개인 계정 불가)
- Facebook 비즈니스 페이지 (Instagram 계정과 연결 필요)
- Meta (Facebook) 개발자 계정
Instagram 계정 전환 방법
개인 계정이라면 먼저 비즈니스/크리에이터 계정으로 전환해야 합니다:
Instagram 앱 → 설정 → 계정 → 프로페셔널 계정으로 전환 → "크리에이터" 또는 "비즈니스" 선택
Facebook 페이지와 Instagram 연결
1. Facebook 페이지 만들기 (이미 있다면 건너뛰기)
2. Facebook 페이지 설정 → "연결된 계정" → "Instagram"
3. "Instagram 계정 연결" → Instagram 비즈니스 계정 로그인 및 연결
Meta 개발자 앱 생성
developers.facebook.com에서 앱을 만듭니다.
1. "앱 만들기" 클릭
2. 사용 사례: "기타" 선택
3. 앱 유형: "비즈니스" 선택
4. 앱 이름 입력 → "앱 만들기"
Instagram Graph API 추가
앱 대시보드 → "제품 추가" 섹션:
1. "Instagram"을 찾아 "설정" 클릭
2. 왼쪽 메뉴에 Instagram 항목이 추가됩니다
권한 설정
Graph API 탐색기에서 아래 권한들을 활성화합니다:
instagram_basic— 계정 정보 읽기instagram_content_publish— 콘텐츠 게시pages_show_list— 페이지 목록 조회pages_read_engagement— 페이지 참여도 읽기
페이지 액세스 토큰 발급
Graph API 탐색기에서 토큰을 발급합니다.
1. 상단에서 본인의 앱을 선택
2. "사용자 또는 페이지" → 본인의 Facebook 페이지 선택
3. 필요한 권한 체크 → "Generate Access Token"
4. 생성된 페이지 액세스 토큰을 복사
Instagram 비즈니스 계정 ID 확인
Graph API 탐색기에서 다음을 입력합니다:
GET /me/accounts?fields=instagram_business_account{id,username}
응답에서 instagram_business_account.id 값을 복사합니다.
이것이 Instagram Graph API에서 사용할 Instagram 비즈니스 계정 ID입니다.
장기 토큰 교환 (60일)
단기 토큰을 장기 토큰으로 교환합니다:
https://graph.facebook.com/v19.0/oauth/access_token?grant_type=fb_exchange_token&client_id={앱_ID}&client_secret={앱_시크릿}&fb_exchange_token={단기_토큰}
앱 ID와 앱 시크릿은 앱 설정 → 기본 설정에서 확인합니다.
AutoPost 웹앱에 입력
AutoPost 웹앱 로그인 후 설정 페이지 → Instagram 섹션:
1. Instagram Business Account ID 입력
2. 페이지 액세스 토큰 (장기) 입력
3. "저장" 후 "연동 테스트" 클릭
Instagram Graph API 제한 사항
- • 이미지/동영상 게시만 가능 (텍스트만 게시 불가)
- • 이미지는 공개 URL로 호스팅 필요 (AutoPost가 자동 처리)
- • 24시간 당 게시 횟수 제한: 50건
- • Reels, Stories는 별도 API 필요
- • 토큰 갱신: 60일마다 필요 (만료 전 갱신 권장)