Pinterest | 포샌디 문서

준비 중인 채널

포샌디로 AI가 Pinterest에 핀을 만들게 될 방법이에요. 핀 하나에 이미지나 영상 하나, 핀이 들어갈 보드와 기본 보드, Pinterest API로 안 되는 것을 정리했어요.

준비 중인 채널이에요. 아래는 연결이 열리면 쓰게 될 방법이에요. 열리면 블로그와 이 페이지에 알려드려요.

한눈에

항목	종류	값
글자 수	텍스트	800
이미지	미디어	글 하나에 1장까지. 더 넣으면 앞의 1장만 올라가고 경고가 붙어요
캐러셀	미디어	안 됨
영상	미디어	글 하나에 1개
텍스트만	미디어	안 됨 (미디어 필수)
24시간 발행	한도	25
24시간 삭제	한도	이 계정이 만든 핀만 삭제 가능, 하루 한도는 공개된 값 없음
상태	상태	준비 중

연결이 열리면 서버가 이 값으로 검사하게 돼요. 핀 하나에는 이미지 1장이나 영상 1개가 들어가요. 글자만으로는 핀을 만들 수 없고, 이미지와 영상을 섞을 수도 없어요. 설명은 800자까지 넣을 수 있어요.

핀이 들어갈 보드

Pinterest를 연결할 때 기본 보드를 하나 고르게 돼요.

options.pinterest.boardId가 없는 핀은 기본 보드로 가요.
포샌디는 글을 만들 때 그 보드를 글에 같이 적어 둬요. 그래서 나중에 기본 보드를 바꿔도, 이미 예약해 둔 핀은 처음 정한 보드로 가요.
계정의 보드 목록은 list_accounts가 보여줘요.
연결한 뒤 Pinterest에서 새로 만든 보드는 refresh_account를 부른 다음에 보여요.
비밀 보드는 목록에 나오지 않아요.

첫 핀 만들기

이미지 1장이나 영상 1개, 그리고 설명을 넣어 publish를 부르게 돼요.

핀을 눌렀을 때 어딘가로 가게 하려면 제목과 https 링크를 넣어요.
영상 핀은 처리에 시간이 걸려요. wait: true를 넣고, 핀이 올라간 다음에 링크를 알려줘요.

curl -X POST https://api.posendy.com/v1/posts \
  -H "Authorization: Bearer $POSENDY_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	핀을 넣을 보드 id예요. `list_accounts`의 `pinterest.boards`에서 찾아요. 빼면 연결할 때 고른 기본 보드로 가요.
`title`	string	핀 제목이에요. 100자까지. 본문(`content`)은 핀 설명이 돼요.
`link`	string	핀을 열었을 때 이동할 주소예요. `https://`로 시작하고 2,048자까지.
`altText`	string	화면 낭독기를 쓰는 사람을 위한 이미지 설명이에요. 500자까지.
`isAiGenerated`	boolean	이미지나 영상을 AI로 만들었거나 고쳤다는 표시예요. Pinterest가 핀에 AI 표시를 붙여요. 첨부 파일에 AI 제작 표시가 있으면 포샌디가 자동으로 켜요.
`coverMediaId`	string	영상 핀 커버로 쓸 JPEG나 PNG의 미디어 id예요. 영상 핀만.
`coverKeyFrameSeconds`	number	`coverMediaId`가 없을 때, 영상 몇 초 장면을 커버로 쓸지예요. 영상 핀만. 둘 다 빼면 Pinterest가 첫 장면을 골라요.
`content`	string	이 채널에만 보낼 본문이에요. 넣으면 공통 본문 대신 이 값이 나가고, 글자 수와 미디어 검사도 이 값으로 해요. 안 넣으면 공통 본문을 써요.

다른 채널과 같이, 이 채널에만 보낼 본문 content도 받게 돼요.

안 되는 것

댓글과 답글: Pinterest API에 없어요. 그래서 list_replies와 reply는 지원하지 않는다고 답하게 돼요.
올린 핀 수정: Pinterest가 베타 목록에 있는 앱에만 열어 둔 기능이에요.
이미지 여러 장짜리 캐러셀

숫자는 노출, 반응, 댓글, 저장을 받게 돼요. 저장 수는 reposts 칸에 들어가요.

자주 묻는 것

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

포샌디는 Pinterest에 보드 읽기 권한만 요청하고, 비밀 보드 읽기 권한은 요청하지 않아요. 그래서 비밀 보드는 목록에 없어요. 공개 보드에 올리거나, Pinterest에서 그 보드를 공개로 바꾼 뒤 계정을 다시 불러와요.

Pinterest에서 기본 보드를 지우면 어떻게 되나요?

다음에 보드 목록을 읽을 때 연결 카드에 기본 보드가 없다는 안내가 뜨고, 새로 고르라고 나와요. 고르기 전에는 보드를 정하지 않은 핀이 엉뚱한 보드로 가지 않고 거절돼요.

연결을 끊으면 Pinterest에서도 포샌디가 지워지나요?

연결을 끊으면 포샌디가 갖고 있던 토큰은 지워져요. 하지만 Pinterest는 앱이 로그인 권한을 직접 회수하는 방법을 열어 두지 않았어요. 허용한 앱 목록에서도 지우려면 Pinterest 설정 > 보안으로 가요.

이전Bluesky 다음Discord