Pinterest User Boards
Pinterest 보드는 저장한 핀을 이름 붙여 모아 둔 컬렉션으로, 설명, 커버 이미지, 생성일과 함께 핀·팔로워·섹션·협업자 수, 그리고 다른 계정이 핀을 추가할 수 있는지 알려 주는 플래그를 갖고 있습니다. 한 프로필의 보드를 전부 읽어 보면 그 계정이 어떤 주제를 가장 공들여 큐레이션하는지, 어떤 컬렉션이 따로 팔로워를 모으는지, 어디서 공동 참여를 열어 두었는지 드러납니다.
Pinterest User Boards API 주요 기능
- 프로필의 모든 보드urls 배열에 Pinterest 프로필 링크를 하나 이상 넣으면 그 프로필의 보드가 각각 별도 행으로 반환되며, 행마다 보드의 id와 url 값이 담깁니다.
- 보드별 규모와 오디언스metrics.pins_count 값은 보드에 저장된 양을, metrics.followers_count 값은 보드를 팔로우하는 사람 수를 보여 주어 쌓아 두기만 한 보관함과 실제 오디언스가 있는 컬렉션을 구분하게 해 줍니다.
- 공동 보드와 섹션is_collaborative 값은 다른 계정도 핀을 추가할 수 있는 보드를 표시하고, metrics.collaborators_count 값은 그 인원을, metrics.sections_count 값은 보드가 얼마나 세분되어 있는지를 알려 줍니다.
- 이름, 설명, 커버, 생성일name, text, cover_url 값으로 보드의 주제를 한눈에 파악하고, published_at 값으로 보드가 만들어진 시점, 즉 그 주제가 계정에 등장한 때를 알 수 있습니다.
- 프로필당 최대 500개 보드results_limit 값은 프로필마다 따로 적용되며 기본값은 25, 최대 500이므로 보드를 수백 개 운영하는 계정도 빠짐없이 나열할 수 있습니다.
Pinterest User Boards API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | https://www.pinterest.com/marthastewart/처럼 경로에 사용자 이름 하나만 있는 Pinterest 프로필 링크입니다. pinterest.co.uk나 de.pinterest.com 같은 국가별 도메인도 사용할 수 있습니다. |
results_limit | 선택 | 프로필마다 반환할 최대 보드 수로 1~500 사이 정수이며 기본값은 25입니다. |
Pinterest User Boards API 사용 방법
프로필 링크를 제출하고 작업을 기다린 뒤, 보드당 한 행씩 페이지를 넘기며 읽습니다.
- 프로필 링크와 선택 항목인 results_limit 값을 POST /v1/pinterest/user-boards로 보내고, 응답의 task_id 값을 보관합니다.
- status 값이 succeeded가 될 때까지 몇 초마다 GET /v1/tasks/{task_id}를 호출합니다.
- results.items에서 보드를 읽고, has_more 값이 true인 동안 results.next_cursor로 다음 페이지를 요청합니다.
curl -X POST "https://api.socq.ai/v1/pinterest/user-boards" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.pinterest.com/marthastewart/"],"results_limit":25}'
# Each board returned costs 0.5 credits.Pinterest User Boards API 추천 활용 사례
- 경쟁사 Pinterest 주제 점검: 보드의 name과 text 값을 pins_count와 나란히 놓고 브랜드가 꾸준히 저장하는 주제를 확인하며, followers_count와 비교해 그중 사람들이 팔로우하는 컬렉션을 찾습니다.
- 분야별 크리에이터 후보 선별: 후보 크리에이터의 보드를 모아 보드 이름과 설명을 다루려는 주제와 맞춰 보고, 여러 보드에 걸쳐 그 주제를 큐레이션하는 계정만 남깁니다.
- 참여할 만한 공동 보드 찾기: is_collaborative 값이 true인 행만 남기고 collaborators_count와 followers_count 값을 비교해 팔로워가 있는 공동 보드를 고릅니다.
- 성장하는 컬렉션 추적: 같은 프로필을 정기적으로 다시 수집하고 보드 id별로 pins_count와 followers_count 값을 비교해 핀이나 팔로워가 늘어나는 보드를 확인합니다.
Pinterest User Boards API 활용 팁
- 제출 전에 보드 링크나 핀 링크는 프로필 루트까지 잘라 내세요. urls 배열은 https://www.pinterest.com/{username}/ 형식을 받으며, 보드 링크는 Pinterest Board Pins API에 넣어야 합니다.
- 프로필의 보드가 기본값 25개보다 많다면 results_limit 값을 높이세요. 제한은 프로필마다 적용되고 실제로 반환된 보드만 청구됩니다.
- 작업 하나로 여러 프로필을 처리했다면 author.username 값으로 행을 묶으세요. 모든 보드에 소유 계정 정보가 담겨 있습니다.
- 각 보드의 url 값을 Pinterest Board Pins API에 넘겨 핀을 가져오고, 그쪽 results_limit 값은 metrics.pins_count를 보고 정하세요.
관련 API
Pinterest User Boards API 외에 Pinterest의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Pinterest Pins API — 공개 핀 URL을 정규화된 콘텐츠, 크리에이터, 미디어, 분류, 타임스탬프, 공개된 지표로 변환합니다.
- Pinterest User Pins API — 프로필 URL에서 공개 핀을 찾으며, 프로필별 결과 수 제한과 정규화된 콘텐츠, 크리에이터, 미디어, 타임스탬프, 공개된 지표를 포함합니다.
- Pinterest Profiles API — 프로필 URL에서 공개 프로필 정보, 소개, 이미지, 웹사이트, 공개된 계정 수치, 수집 맥락을 수집합니다.
- Pinterest Search API — 텍스트 검색어와 결과 수 제한으로 공개 핀을 검색하고, 정규화된 콘텐츠, 크리에이터, 미디어, 분류, 타임스탬프, 공개된 지표를 반환합니다.
- Pinterest Board Pins API — 보드 URL로 Pinterest 보드의 핀을 보드 순서대로 수집하며 핀 텍스트, 저장한 계정, 원본 이미지, 핀 링크를 포함합니다.
- Pinterest Topic API — Pinterest 아이디어 페이지 URL로 주제별 월간 검색 수, 갱신 시점, 그 아래 추천된 세부 주제를 읽어 옵니다.