인스타그램 프로페셔널 계정에 이미지 자동 게시하는 방법과 제한 조건 정리

인스타그램 콘텐츠 게시 API는 무엇인가요?

인스타그램 콘텐츠 게시 API는 프로페셔널 계정에 사진, 동영상, 릴스, 스토리, 슬라이드를 직접 올릴 수 있게 해주는 공식 게시 기능입니다.

손으로 앱에 접속해 업로드하지 않아도 되며, 예약 발행이나 자동 게시 흐름을 만들 때 활용할 수 있습니다. 다만 개인 계정은 대상이 아니고, 시작 전 계정 유형과 권한 조건을 먼저 맞춰야 합니다.

어떤 형식이 지원되고, 무엇은 안 되나요?

이미지는 JPEG만 지원하며, MPO·JPS 같은 확장 JPEG는 지원되지 않습니다. 슬라이드는 이미지와 동영상을 섞어 최대 10개까지 넣을 수 있습니다.

또한 필터와 쇼핑 태그는 지원되지 않고, 릴스·스토리의 대체 텍스트(alt_text)도 지원되지 않습니다. 슬라이드는 첫 이미지를 기준으로 잘리며 기본 가로세로비는 1:1입니다.

하루에 몇 개까지 올릴 수 있나요?

공식 문서에는 24시간 내 최대 100개라는 제한이 보이지만, 슬라이드 설명 안에는 50개로 적힌 부분도 있어 표기가 상충합니다.

따라서 실제 운영 전에는 공식 페이지에서 다시 확인하는 것이 안전합니다. 현재 사용량은 GET /content_publishing_limit 엔드포인트로 조회할 수 있어 예약 발행 앱이라면 사전 점검이 필요합니다.

게시하려면 무엇을 먼저 준비해야 하나요?

가장 먼저 프로페셔널 계정이어야 하고, 미디어 파일을 공개 접근 가능한 서버에 올려 둘 준비가 필요합니다.

image_url과 video_url 방식은 게시 시점에 API가 해당 URL에서 파일을 가져오므로 공개 서버가 필수입니다. 반면 재개 가능한 동영상 업로드는 로컬 파일도 지원합니다.

실제 게시 과정은 어떻게 진행되나요?

게시는 컨테이너를 만든 뒤 그 컨테이너를 게시하는 2단계로 진행됩니다.

먼저 /media로 컨테이너를 만들고, 반환된 컨테이너 ID를 /media_publish에 넣어 게시합니다. 동영상은 처리 시간이 걸릴 수 있으므로 status_code를 확인해 FINISHED인지 점검해야 하며, 컨테이너는 24시간 안에 게시하지 않으면 EXPIRED로 만료됩니다.

인스타그램 개인 계정도 자동 게시가 되나요?

아니요. 이 API는 Instagram 프로페셔널 계정을 대상으로 하며, 개인 계정은 게시 대상이 아닙니다.

슬라이드는 몇 장까지 넣을 수 있나요?

슬라이드는 이미지와 동영상을 섞어 최대 10개까지 넣을 수 있습니다. 다만 문서 내 다른 부분에 50개 표기가 있어 공식 페이지 재확인이 필요합니다.

컨테이너를 만든 뒤 바로 게시하지 않으면 어떻게 되나요?

컨테이너는 24시간 안에 게시하지 않으면 만료됩니다. 만들어만 두고 방치하면 사용할 수 없게 됩니다.