Tell your agent, and it posts to every channel you connected

채널

에이전트가 업리카로 핀을 만드는 방법. 핀 하나에 이미지 하나나 영상 하나, 핀이 들어갈 보드와 기본 보드, 그리고 핀터레스트 API 가 못 하는 것.

한눈에

이름	타입	설명
`characters`	text	800
`images`	media	up to 1 per post; more than that and the first 1 go out with a warning
`carousel`	media	not supported
`video`	media	1 per post
`text alone`	media	media required
`posts / 24h`	limit	25
`deletes / 24h`	limit	Pinterest deletes Pins this account created, with no documented daily cap
`status`	state	soon

이 숫자는 서버가 검증에 쓰는 파일에서 그대로 옵니다. 핀 하나는 이미지 하나 아니면 영상 하나입니다. 글만으로는 안 되고 이미지와 영상을 섞을 수도 없습니다. 설명은 800자까지 들어갑니다.

핀은 어느 보드로 가나요?

핀터레스트를 연결할 때 기본 보드를 고릅니다. options.pinterest.boardId 가 없는 핀은 그 보드로 가고, 업리카가 글을 만들 때 그 보드를 글에 적어 둡니다. 그래서 나중에 기본 보드를 바꿔도 예약해 둔 핀은 처음 정한 보드로 갑니다. 계정마다 보드 목록은 list_accounts 가 보여 줍니다. 연결한 뒤 핀터레스트에서 만든 보드는 refresh_account 뒤에 보입니다. 비밀 보드는 목록에 없습니다.

첫 핀은 어떻게 만드나요?

이미지 하나나 영상 하나와 설명으로 publish 를 부릅니다. 핀이 어딘가로 이어지게 하려면 제목과 https 링크를 줍니다. 영상 핀은 처리에 시간이 걸리니 wait: true 를 주고 핀이 나간 뒤에 링크를 알려 주세요.

curl -X POST https://api.uplika.com/v1/posts \
  -H "Authorization: Bearer $UPLIKA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Five desk setups that fit a small room.",
    "accountIds": ["conn_..."],
    "mediaIds": ["med_..."],
    "options": { "pinterest": { "title": "Small room desk setups", "link": "https://example.com/desks" } }
  }'

options.pinterest 가 받는 것

이름	타입	설명
`boardId`	string	The id of the board to pin to, from list_accounts (pinterest.boards). Leave it out to use the board the person picked as the default when they connected Pinterest.
`title`	string	The Pin title, up to 100 characters. The text (content) becomes the Pin description.
`link`	string	Where the Pin goes when someone opens it. An https:// address, up to 2,048 characters.
`altText`	string	Alt text describing the image for people using screen readers, up to 500 characters.
`isAiGenerated`	boolean	The image or video was made or changed with AI. Pinterest shows an AI label on the Pin. Uplika turns this on when an attached file is marked as AI-made.
`coverMediaId`	string	Media id of a JPEG or PNG to use as the video Pin's cover. Video Pins only.
`coverKeyFrameSeconds`	number	Which second of the video to use as the cover when coverMediaId is not given. Video Pins only. Leave both out and Pinterest picks the first frame.
`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.

서버가 검증에 쓰는 스키마에서 그대로 만듭니다. 다른 채널처럼 content, 이 채널에만 나가는 다른 본문도 받습니다.

안 되는 것은?

댓글과 답글. 핀터레스트 API 에 없어서 list_replies · reply 는 못 한다고 답합니다. 나간 핀의 수정. 핀터레스트가 베타 목록에 든 앱에만 엽니다. 이미지 여러 장짜리 캐러셀. 지표는 노출 · 반응 · 댓글 · 저장이고 저장 수는 reposts 칸으로 나갑니다.

자주 묻는 것

비밀 보드는 왜 못 고르나요?

업리카는 핀터레스트에 보드를 읽는 권한만 요청하고 비밀 보드를 읽는 권한은 요청하지 않아서, 비밀 보드는 목록에 없습니다. 공개 보드에 올리거나, 핀터레스트에서 보드를 공개로 바꾼 뒤 계정을 새로 읽으세요.

핀터레스트에서 기본 보드를 지우면 어떻게 되나요?

다음에 보드를 읽을 때 연결 카드가 기본 보드가 없다고 알리고 고르라고 합니다. 고르기 전에는 보드를 정하지 않은 핀이 엉뚱한 곳으로 가지 않고 거절됩니다.

연결을 해제하면 핀터레스트에서도 업리카가 지워지나요?

해제하면 업리카가 갖고 있던 토큰이 지워집니다. 핀터레스트는 앱이 로그인을 직접 회수하는 길을 열어 두지 않아서, 허용한 앱 목록에서도 지우려면 핀터레스트 설정 → 보안으로 가세요.