채널

Instagram

에이전트가 업리카로 인스타그램에 올리는 방법. 피드·릴스·스토리가 각각 무엇을 받고, API 가 못 하는 것은 무엇인지.

한눈에

이름	타입	설명
`characters`	text	2,200
`images`	media	up to 10 per post; more than that and the first 10 go out with a warning
`carousel`	media	2-10 items, images and video can be mixed
`video`	media	1 per post
`text alone`	media	media required
`posts / 24h`	limit	100
`deletes / 24h`	limit	Instagram only on accounts connected via Facebook, with no documented daily cap
`status`	state	live

이 숫자는 서버가 검증에 쓰는 파일에서 그대로 옵니다. 인스타그램은 글만으로는 안 올라갑니다. 모든 글에 이미지나 영상이 하나는 있어야 하고, 이미지는 JPEG 만 받아서 다른 형식은 발행 전에 변환합니다. 원본은 그대로 둡니다.

연결 경로는 둘, 채널은 하나

인스타그램 계정은 직접(Instagram 로그인) 붙거나 연결된 Facebook 페이지를 거쳐(Facebook 로그인) 붙습니다. 발행은 같습니다. 차이는 그 밖의 권한에서 납니다. 업리카로 글을 지우는 것은 Facebook 경유 계정에서만 됩니다. 직접 로그인에는 삭제 권한이 없습니다.

피드, 릴스, 스토리?

options.instagram.contentType 이 고릅니다. 안 주면 영상 하나는 릴스, 나머지는 피드입니다. 스토리는 이미지나 영상 정확히 하나이고 캡션도 첫 댓글도 없습니다. 캐러셀은 피드 글 하나에 2~10개입니다.

첫 글은 어떻게 올리나요?

이미지를 올리고 그 미디어 id 로 publish 를 부릅니다. contentType 은 선택입니다.

curl -X POST https://api.uplika.com/v1/posts \
  -H "Authorization: Bearer $UPLIKA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Caption under the photo",
    "accountIds": ["conn_..."],
    "mediaIds": ["med_..."],
    "options": { "instagram": { "contentType": "feed", "firstComment": "#hashtags #here" } }
  }'

options.instagram 이 받는 것

이름	타입	설명
`contentType`	feed \| story \| reel	What kind of post. Defaults to reel for a single video and feed otherwise. Stories show no caption and take one image or video.
`shareToFeed`	boolean	Reels only. false keeps the reel out of the main feed.
`coverMediaId`	string	Media id of a JPEG up to 8MB to use as the reel cover. Reels only.
`thumbOffsetMs`	number	Reel cover frame in milliseconds. Ignored when coverMediaId is set.
`collaborators`	string[]	Up to 3 public professional accounts to invite as collaborators. They appear only after accepting. Not on stories.
`userTags`	object[]	Tag accounts on the media. Photos need x and y between 0 and 1; videos take the username alone. mediaIndex picks the carousel slide. (API only; the dashboard does not draw it.)
`isAiGenerated`	boolean	Set true to label the media as AI-generated on Instagram.
`firstComment`	string	A comment we post right after publishing, often used for hashtags. Not on stories. If it fails the post still goes up, with a warning.
`content`	string	Text for this channel only. When set it replaces the shared content for this channel, and the length and media checks use it. Leave it out to use the shared content.

서버가 검증에 쓰는 스키마에서 그대로 생성했습니다. GET /v1/platforms 도 같은 것을 줍니다.

안 되는 것은?

올라간 글 수정(인스타그램에 수정 API 가 없습니다), DM, 그리고 Instagram 로그인으로 붙은 계정의 삭제. 지표는 피드와 릴스에서 get_insights 로 옵니다. 스토리는 24시간 뒤 사라지고 아무것도 보고하지 않습니다.

자주 묻는 것

PNG 가 왜 변환됐나요?

인스타그램은 JPEG 만 받습니다. 다른 이미지는 발행 전에 JPEG 로 바꾸고 올린 원본 파일은 그대로 둡니다.

스토리에 캡션이 왜 없나요?

스토리는 캡션을 아예 안 보여 줍니다. 보낸 글은 잃어버린 게 아니라 스토리에 자리가 없는 것입니다. 피드 글에 넣으세요.

글을 지울 수 있나요?

Facebook 을 거쳐 붙은 계정에서만. Instagram 로그인에는 삭제 권한이 없어서 그 계정은 인스타그램 앱에서 지웁니다.