인스타그램 API, 연결 6단계와 기능별 자동화 범위표
인스타그램 API로 게시 · 댓글 · 인사이트 · 메시지를 다룰 때 통합 로그인 · 인스타그램 로그인 · 페이스북 로그인 세 방식에서 되는 기능 범위표, 메타 앱 만들기부터 장기 토큰까지 연결 6단계, 앱 검수가 필요한 경우, 24시간 게시 한도와 홈페이지에 피드를 띄우는 두 가지 방법을 메타 개발자 문서 기준으로 정리했습니다.

인스타그램 API는 프로페셔널 계정(비즈니스 · 크리에이터 계정)에서만 쓸 수 있고, 게시 · 댓글 관리 · 인사이트 · 메시지를 프로그램으로 다룰 수 있습니다. 다만 API로 게시할 수 있는 수가 24시간 단위로 정해져 있고, 자기 계정이 아닌 남의 계정까지 다루려면 메타의 앱 검수를 받아야 합니다. 그래서 만들기 전에 어떤 연결 방식으로, 어느 계정을, 어떤 기능까지 쓸지 범위부터 정합니다.
인스타그램 API로 무엇을 할 수 있나요
메타 문서는 연결 방식을 셋으로 나눕니다. 새로 만드는 연동에 권하는 통합 로그인(인스타그램 · 페이스북 계정 어느 쪽으로든 로그인), 이미 쓰던 인스타그램 로그인, 페이스북 페이지와 이어진 계정을 위한 페이스북 로그인입니다. 방식마다 되는 기능이 조금씩 다릅니다.
| 기능 | 통합 로그인 | 인스타그램 로그인 | 페이스북 로그인 | 메모 |
|---|---|---|---|---|
| 게시(사진 · 영상 · 릴스 · 스토리 · 캐러셀) | 가능 | 가능 | 가능 | 사진은 JPEG만, 캐러셀은 20개까지 |
| 댓글 읽기 · 답글 · 숨기기 | 가능 | 가능 | 가능 | 내 계정 게시물의 댓글 |
| 인사이트(도달 · 프로필 방문 등) | 가능 | 가능 | 가능 | 팔로워 100명 미만 계정은 일부 지표 없음 |
| 메시지(DM) 응대 | 가능 | 가능 | 메신저 플랫폼으로 | 상담 도구와 잇는 경우 |
| 해시태그 검색 | 가능 | 안 됨 | 가능 | 공개 콘텐츠 접근 기능 필요 |
| 상품 태그 | 가능 | 안 됨 | 가능 | 게시 요청 자체는 쇼핑 태그 미지원 |
| 페이스북 페이지 | 필요 없음 | 필요 없음 | 필요 | 통합 로그인은 비즈니스 포트폴리오 필요 |
게시 수 한도는 공식 문서 본문에 24시간 이동 기준 API 게시물 100건(캐러셀은 1건으로 셈)으로 적혀 있습니다. 같은 문서 캐러셀 절에는 50건으로 적힌 곳도 있어, 계정의 실제 사용량은 content_publishing_limit 조회로 확인하세요. 게시는 이미지 주소로 컨테이너(게시 준비 묶음)를 만든 뒤 media_publish 로 올리는 두 단계이고, 메타가 그 주소에서 파일을 가져가므로 이미지는 공개된 서버에 있어야 합니다. 예약 게시는 프로그램이 정한 시각에 이 요청을 보내는 방식이라, 공식 문서도 예약 기능을 둔다면 앱 쪽에서 게시 수를 함께 세라고 권합니다.
연결하려면 어떤 계정과 앱이 필요한가요
회사 계정 하나를 자기 프로그램에 잇는 경우를 기준으로 한 순서입니다. 앱 대시보드에서 인스타그램 제품을 추가하면 인스타그램 로그인 설정이 기본으로 붙고, 페이스북 페이지와 이어진 계정이라면 페이스북 로그인 설정을 고릅니다.
| 단계 | 할 일 | 확인할 것 |
|---|---|---|
| 1. 계정 확인 | 회사 인스타그램 계정이 프로페셔널 계정인지 봅니다 | 개인 계정이면 먼저 전환 |
| 2. 메타 앱 만들기 | 메타 앱 대시보드에서 앱을 만들고 사용 사례는 기타, 앱 유형은 비즈니스를 고릅니다 | 연락 메일은 회사 공용 주소로 |
| 3. 인스타그램 제품 추가 | 제품 목록의 Instagram 에서 설정을 누릅니다 | 페이지 연결 계정이면 페이스북 로그인 설정 |
| 4. 계정 추가 · 토큰 발급 | 쓸 인스타그램 계정을 추가하고 로그인해 액세스 토큰을 받습니다 | 추가하는 계정은 공개 계정 |
| 5. 장기 토큰으로 바꾸기 | 1시간짜리 단기 토큰을 60일짜리 장기 토큰으로 바꿉니다 | 만료 전에 갱신하는 작업 예약 |
| 6. 첫 호출 · 웹훅 설정 | 게시물 목록을 한 번 불러 보고, 댓글 알림이 필요하면 웹훅 주소를 넣습니다 | 앱 비밀 키는 서버에만 보관 |
앱 대시보드는 앱을 정식으로 공개하기 전에 비즈니스 인증을 마친 비즈니스와 연결하라고 안내합니다. 앱과 비즈니스 포트폴리오는 처음부터 회사 명의로 만들어 두면 담당자가 바뀌어도 권한을 넘기기 쉽습니다. 여러 프로그램을 잇는 일반 순서는 API 연동 진행 6단계와 같습니다.
앱 검수는 언제 받아야 하나요
기준은 누구의 계정을 다루느냐입니다. 자기 회사 계정이나 관리하는 계정만 쓴다면 기본값인 표준 접근으로 충분하고, 이때는 로그인 화면을 따로 만들지 않아도 앱 대시보드에서 앱 ID · 비밀 키와 장기 토큰을 받아 씁니다. 남의 프로페셔널 계정에 서비스하는 도구라면 고급 접근이 필요하고, 고급 접근은 앱 검수와 비즈니스 인증을 거쳐야 받습니다. 표준 접근은 범위가 좁아 일부 기능이 제대로 돌지 않을 수 있다는 단서도 붙어 있으니, 시험 단계에서 쓸 기능을 하나씩 호출해 보세요.
| 하려는 일 | 필요한 권한(인스타그램 로그인 기준) | 자기 계정만 | 남의 계정까지 |
|---|---|---|---|
| 프로필 · 게시물 읽기 | instagram_business_basic | 표준 접근 | 고급 접근 · 앱 검수 |
| 자동 게시 · 예약 게시 | basic + instagram_business_content_publish | 표준 접근 | 고급 접근 · 앱 검수 |
| 댓글 관리 | basic + instagram_business_manage_comments | 표준 접근 | 고급 접근 · 앱 검수 |
| 인사이트 모으기 | basic + instagram_business_manage_insights | 표준 접근 | 고급 접근 · 앱 검수 |
| 메시지 응대 | basic + instagram_business_manage_messages | 표준 접근 | 고급 접근 · 앱 검수 |
광고 집행과 성과 보고는 이 연동과 별개로 광고 관리자에서 합니다. 캠페인 만드는 순서는 메타 광고 관리자 설정에 정리돼 있습니다.
홈페이지에 피드를 띄우려면 어떻게 하나요
게시물 몇 개를 고정해서 보여 줄지, 최근 게시물을 자동으로 바꿔 보여 줄지에 따라 방법이 갈립니다.
- 게시물 몇 개 고정: 공개 게시물의 퍼가기 코드나 oEmbed(게시물 주소를 넣으면 넣을 HTML을 돌려주는 창구)를 씁니다. oEmbed는 1시간에 1,000회까지 부를 수 있고, 비공개 · 연령 제한 계정과 스토리는 되지 않으며, 받은 메타데이터를 저장하거나 분석에 쓰는 것은 금지돼 있습니다.
- 최근 게시물 자동 표시: 회사 계정의 장기 토큰으로 서버가 게시물 목록을 불러 와 홈페이지에 보여 줍니다. 방문자가 올 때마다 API를 부르지 않도록 몇 분 간격으로 불러 온 목록을 쓰고, 60일 토큰 갱신을 함께 걸어 둡니다.
예전 피드 위젯 가운데 개인 계정을 쓰던 것은 기본 디스플레이 API 종료(2024년 12월 4일) 뒤 멈췄습니다. 위젯이 비어 있다면 계정을 프로페셔널 계정으로 바꾸고 위 둘 가운데 하나로 다시 연결하세요.
자주 묻는 질문
개인 계정도 인스타그램 API로 연결할 수 있나요?
연결할 수 없습니다. 메타 문서는 앱 사용자가 프로페셔널 계정(비즈니스 · 크리에이터)을 가지고 있어야 한다고 적고, 인사이트 API도 개인 계정의 게시물 자료는 가져오지 못한다고 밝힙니다. 개인 계정을 다루던 기본 디스플레이 API는 2024년 12월 4일에 제공이 끝났습니다. 계정을 프로페셔널 계정으로 바꾼 뒤 연결하세요.
액세스 토큰은 얼마나 유지되나요?
로그인으로 처음 받는 단기 토큰은 1시간, 이를 바꿔 받는 장기 토큰은 60일 동안 쓸 수 있고 만료 전에 갱신할 수 있습니다. 홈페이지 피드나 예약 게시처럼 계속 돌아가는 기능은 토큰 갱신을 서버의 정기 작업으로 넣어 두세요. 갱신을 놓치면 어느 날 피드가 비고 게시가 멈춥니다.
고객사 계정까지 관리하는 도구를 만들려면 무엇이 더 필요한가요?
자기 계정이나 관리하는 계정이 아닌 프로페셔널 계정에 서비스하려면 고급 접근이 필요하고, 고급 접근은 메타 앱 검수와 비즈니스 인증을 거쳐야 받습니다. 메타 문서는 검수자가 앱을 시험해 볼 수 없는 경우(사내망 뒤에 있거나 화면이 없는 앱) 요청할 수 있는 권한을 instagram_basic · instagram_manage_comments 두 가지로 좁혀 두고 있습니다. 그래서 권한을 쓰는 화면을 먼저 완성한 뒤 검수를 신청하는 것이 순서입니다.
인스타그램 API 연동을 외부에 맡길 때 무엇을 정해 두나요?
쓸 기능(게시 · 댓글 · 인사이트 · 메시지), 연결할 계정 수와 그 계정이 누구 것인지, 메타 앱과 비즈니스 포트폴리오를 어느 명의로 만들지, 토큰 갱신과 오류 알림을 누가 받을지를 적어 두세요. 비용은 기능 수, 앱 검수가 필요한지, 예약 게시 화면이나 성과 대시보드 같은 화면 개발 범위로 정해집니다. 이 목록을 그대로 보내면 API 연동 개발 견적을 같은 기준으로 받을 수 있습니다.
오늘 할 일
회사 인스타그램 계정이 프로페셔널 계정인지, 페이스북 페이지와 연결돼 있는지 확인하세요.
이어서 읽기 — 구글 시트 API, 서비스 계정 연결 6단계와 호출 한도표



