자료실
가이드마케팅·콘텐츠뉴런 제작

바뀐 인스타그램 API 연결, 원리와 구조

1. 무엇이 바뀌었나

Meta는 2026년 10월 13일 인스타그램 API 안내 문서를 고치면서 연결 방식을 정리했습니다. 이제 새로 만드는 Meta 앱에서는 'Instagram 로그인' 방식을 고를 수 없습니다.

예전에는 인스타그램 프로페셔널 계정 하나만 있으면 인스타그램 계정으로 로그인해 바로 토큰을 받을 수 있었습니다. 가장 쉬운 방법이어서 인터넷의 많은 자료가 이 방식으로 설명되어 있습니다. 그런데 지금 그 자료대로 따라 하면 중간에 버튼이 보이지 않거나, 앱 화면에 이런 문구가 나옵니다.

최신 앱에서는 Instagram 로그인이 포함된 API 설정을 사용할 수 없습니다. 대신 앱이 통합된 로그인이 포함된 API 설정을 사용합니다.

화면이 틀린 것이 아니라 방식이 바뀐 것입니다. 이미 Instagram 로그인으로 만들어 둔 앱은 아직 작동합니다(종료일은 발표되지 않았습니다).


2. 내게 맞는 방식 고르기

새로 시작한다면 길은 두 가지입니다.

방식필요한 것이럴 때
통합 로그인 (새 앱의 기본)Meta 비즈니스 인증을 마친 비즈니스 포트폴리오비즈니스 인증을 마쳤을 때. Meta의 새 기능은 이 방식에만 나옵니다
Facebook 로그인Facebook 페이지 + 페이지에 연결한 인스타그램 프로페셔널 계정비즈니스 인증을 받지 않았을 때(개인, 인증 전 사업자)
  • 통합 로그인은 앱을 만들 때 비즈니스 포트폴리오를 연결해야 다음으로 넘어갑니다. 인증을 마치지 않은 포트폴리오로는 진행할 수 없었습니다.
  • 비즈니스 인증은 Meta가 비즈니스의 법적 이름·주소·전화번호·웹사이트(https 주소)를 확인하는 절차입니다. 정보가 기록과 맞지 않으면 사업자등록증 같은 공식 문서를 올려야 해서, 사업자등록이 없는 개인은 받을 수 없습니다. 개인사업자는 사업자등록이 있으면 신청할 수 있습니다.
  • Facebook 로그인은 "계속 작동하지만 더 이상 업데이트되지 않는다"고 안내되어 있습니다. 지금 쓰는 데는 문제가 없지만, 앞으로 Meta가 바꿀 수 있다는 점은 알아 두세요.

Meta 앱 설정 화면에 나오는 안내입니다. Instagram 로그인은 "사용할 수 없다", Facebook 로그인은 "계속 작동하지만 업데이트되지 않는다"로 서로 다르게 안내됩니다.

이 자료는 Facebook 로그인 기준입니다. 비즈니스 인증 없이 내 계정에 게시하고 성과를 조회하는 것까지 2026년 11월에 직접 확인했습니다.


3. 연결의 구조

3-1. API

API는 프로그램이 다른 서비스에 정해진 형식으로 요청을 보내고 결과를 받는 방법입니다. 사람은 인스타그램 앱 화면에서 사진을 고르고 버튼을 눌러 게시합니다. 자동화 도구는 화면 없이 인스타그램 API로 "이 계정에, 이 이미지 URL과 캡션으로 게시물을 만들어 달라"는 요청을 보냅니다.

요청마다 액세스 토큰이 함께 갑니다. Meta는 이 토큰으로 어느 앱이 어느 계정에서 어떤 권한을 허용받았는지 확인하고, 허용된 요청만 처리합니다.

3-2. 연결에 필요한 여섯 가지

구성 요소설명
인스타그램 프로페셔널 계정비즈니스 또는 크리에이터 계정. API로 게시하려면 이 계정 유형이어야 하며, 개인 계정은 API로 게시할 수 없습니다
Facebook 페이지인스타그램 프로페셔널 계정을 연결하는 Facebook 페이지. Facebook 로그인 방식에서 API는 이 페이지를 통해 인스타그램 계정을 찾습니다
Meta 앱Meta 개발자 사이트에 등록하는 앱. 이용 사례와 권한을 설정하며, 액세스 토큰은 이 앱에 대해 발급됩니다
액세스 토큰사용자가 앱에 허용한 권한이 담긴 문자열. API 요청마다 함께 보내며, 다른 사람에게 드러나면 안 됩니다
이미지 호스팅사진·영상 파일을 공개 URL로 제공하는 서비스(예: Cloudinary). 인스타그램은 이 URL에서 파일을 내려받습니다
자동화 도구액세스 토큰으로 API에 요청을 보내 게시와 조회를 실행하는 프로그램

내 계정에만 게시한다면 Meta 앱을 개발 모드로 두고 쓸 수 있습니다. 개발 모드의 앱은 앱에 역할이 있는 사용자의 계정에서만 작동합니다.

3-3. Facebook 페이지가 필요한 이유

Facebook 로그인 방식의 액세스 토큰은 Facebook 계정으로 발급됩니다. 그래서 인스타그램 계정은 다음 순서로 찾습니다.

  1. 토큰으로 내가 관리하는 Facebook 페이지 목록을 조회합니다.
  2. 그 페이지에 연결된 인스타그램 프로페셔널 계정의 번호(ID)를 조회합니다.
  3. 그 계정 번호로 게시하거나 인사이트를 조회합니다.

페이지와 인스타그램 계정이 연결되어 있지 않으면 2번에서 계정 번호가 나오지 않습니다. 토큰은 받았는데 인스타그램 계정을 찾지 못하는 상태가 됩니다.

3-4. 권한

권한은 액세스 토큰으로 할 수 있는 일의 범위입니다. 토큰을 받을 때 고른 권한만 쓸 수 있습니다. Facebook 로그인 방식에서는 인스타그램 권한만으로는 부족하고, 페이지를 조회하는 Facebook 페이지·비즈니스 권한이 함께 필요합니다.

토큰에 없는 권한이 필요한 요청은 권한 오류로 거절됩니다. 앱에 권한을 추가한 뒤 토큰을 다시 받아야 합니다. 이미 받은 토큰에 권한이 추가되지는 않습니다.

3-5. 액세스 토큰의 세 가지 종류

종류설명만료
단기 토큰권한을 허용하면 처음 발급되는 토큰1시간
확장 토큰단기 토큰을 확장해 발급받는 장기 토큰장기 사용
페이지 토큰확장 토큰으로 발급받는, 인스타그램 계정이 연결된 Facebook 페이지의 토큰만료 없음

단기 토큰을 그대로 저장하면 1시간 뒤 요청이 거절됩니다.

약 90일마다 다시 허용해야 합니다. 토큰에 만료가 없어도, 앱을 허용한 날로부터 약 90일이 지나면 이 앱의 데이터 접근이 끝납니다. 이것을 데이터 접근 만료라고 합니다. 그 전에 다시 허용하고 토큰을 새로 받아야 합니다.


4. 큰 순서

묶음하는 일
1. 계정 준비인스타그램을 프로페셔널 계정으로 전환하고, Facebook 페이지에 연결합니다
2. 앱 준비Meta 앱을 만들고, Facebook 로그인 방식으로 필요한 권한을 추가합니다
3. 토큰 받기권한을 허용해 토큰을 받고, 확장한 뒤 페이지 토큰으로 바꿉니다
4. 보관토큰과 인스타그램 계정 번호를 설정 파일(.env)에 저장합니다

앞 묶음이 끝나야 다음 묶음이 됩니다. 그다음 이미지 호스팅을 준비하면 자동화 도구로 첫 게시를 보낼 수 있습니다.


5. 게시할 때 안에서 일어나는 일

인스타그램 API는 PC 파일을 받지 않습니다. 공개 URL을 알려 주면 인스타그램이 그 URL에서 파일을 내려받습니다. 그래서 이미지 호스팅이 필요합니다.

단계하는 일알아 둘 것
1. 공개 주소 만들기사진·영상을 이미지 호스팅에 올려 누구나 열 수 있는 URL을 받습니다로그인해야 열리는 드라이브 링크는 인스타그램이 내려받지 못합니다
2. 미디어 컨테이너 만들기이미지 URL과 캡션을 보내면 인스타그램이 파일을 내려받아 게시 전 단계의 컨테이너를 만듭니다여러 장이면 장마다 하나씩 만든 뒤 하나로 묶습니다. 아직 계정에는 보이지 않습니다
3. 처리 기다리기처리가 끝났는지 상태를 확인합니다영상은 보통 1분 안팎, 인스타그램이 붐비면 몇 분 더 걸립니다
4. 게시하기컨테이너를 게시하고 게시물 ID와 링크를 받습니다하루(24시간) 최대 100건

4단계에서 오류가 나도 이미 올라갔을 수 있습니다. 다시 보내기 전에 계정을 먼저 확인하세요. 그래야 같은 글이 두 번 올라가지 않습니다.


6. 액세스 토큰 보관 원칙

토큰만 있으면 다른 사람도 내 계정에 글을 올릴 수 있습니다.

  • 둘 곳은 내 컴퓨터의 설정 파일(.env) 한 곳입니다. 토큰은 내가 직접 붙여 넣습니다.
  • AI 대화창에 붙여 넣지 않습니다. AI 도구에게는 "토큰은 .env에 있다"고만 알려 주고, 프로그램이 파일에서 직접 읽게 합니다.
  • 토큰이 보이는 화면은 캡처하거나 공유하지 않습니다. 메신저·메일·게시판에도 올리지 않습니다.
  • 잘 만든 프로그램은 오류 메시지나 기록에 토큰이 찍히지 않게 가립니다.

실수로 드러났다면 Facebook 설정의 비즈니스 통합에서 이 앱의 연결을 지우거나 Facebook 비밀번호를 바꿉니다. 그러면 그 토큰은 더 이상 쓸 수 없습니다. 그다음 토큰을 새로 받습니다.


7. 자주 막히는 지점

증상원인
'Instagram 로그인'이 보이지 않는다2026년 10월 방식 변경
비즈니스 포트폴리오를 연결하라며 넘어가지 않는다통합 로그인 설정을 고름(인증된 포트폴리오 필요)
토큰은 받았는데 인스타그램 계정이 나오지 않는다페이지와 인스타그램 계정이 연결되지 않음
권한이 없다는 오류필요한 권한이 토큰에 없음
토큰이 만료됐거나 잘못됐다는 오류단기 토큰을 그대로 씀, 비밀번호 변경, 데이터 접근 만료
사진·영상을 가져가지 못했다는 오류URL이 공개되어 있지 않음

8. 한 장 정리

  • 2026년 10월부터 새 앱에서는 Instagram 로그인을 고를 수 없습니다. 비즈니스 인증을 받지 않았다면 Facebook 로그인으로 연결합니다.
  • Facebook 로그인은 Facebook 페이지를 거쳐 인스타그램 계정을 찾습니다. 페이지와 계정 연결이 첫 단계입니다.
  • 액세스 토큰은 앱에 허용한 권한이 담긴 문자열입니다. 토큰을 받을 때 고른 권한만 쓸 수 있습니다.
  • 토큰은 단기 토큰(1시간) → 확장 토큰 → 페이지 토큰(만료 없음) 순서로 받고, 약 90일마다 다시 허용합니다.
  • 인스타그램은 PC 파일 대신 공개 URL에서 파일을 내려받습니다. 그래서 이미지 호스팅이 필요합니다.
  • 토큰은 .env 한 곳에만 두고, AI 대화창에는 붙이지 않습니다.

용어

용어뜻
API프로그램이 다른 서비스에 정해진 형식으로 요청을 보내고 결과를 받는 방법
액세스 토큰사용자가 앱에 허용한 권한이 담긴 문자열
권한액세스 토큰으로 할 수 있는 일의 범위
Meta 앱Meta 개발자 사이트에 등록하는 앱. 개발 모드에서는 앱에 역할이 있는 사용자만 사용
비즈니스 인증Meta가 비즈니스의 법적 이름·주소·전화번호·웹사이트를 확인하는 절차. 사업자등록증 등 공식 문서가 필요합니다
페이지 토큰Facebook 페이지에 대해 발급되는 토큰. 만료가 없습니다
데이터 접근 만료앱을 허용한 날로부터 약 90일 뒤 데이터 접근이 끝나는 날
미디어 컨테이너게시 전에 인스타그램이 만들어 두는 미디어 단위. 게시 요청으로 실제 게시물이 됩니다
이미지 호스팅사진·영상 파일을 공개 URL로 제공하는 서비스
.env비밀 값을 적어 두는 내 컴퓨터의 설정 파일

저작권·출처 문의 newrun.cs@gmail.com

이 가이드가 나온 강의

바이브코딩으로 만드는 인스타 카드뉴스 스튜디오

주제 선정부터 카드뉴스 제작, 승인, 게시 일정, 성과 분석까지. 반복되는 인스타 콘텐츠 업무를 지속 가능한 제작 시스템으로 구축합니다.

강의 보기 →

함께 보면 좋은 자료

자료실 전체 →