pinterest/
user-boards

Pinterest 프로필 URL로 그 계정의 보드를 나열하며, 보드 이름, 설명, 커버, 소유자, 생성일과 핀·팔로워·섹션·협업자 수를 반환합니다.

Pinterest User Boards API

프로필 URL 입력
프로필당 최대 500개 보드
핀 수와 팔로워 수
공동 보드 여부
결과당 0.5 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

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 사용 방법

프로필 링크를 제출하고 작업을 기다린 뒤, 보드당 한 행씩 페이지를 넘기며 읽습니다.

  1. 프로필 링크와 선택 항목인 results_limit 값을 POST /v1/pinterest/user-boards로 보내고, 응답의 task_id 값을 보관합니다.
  2. status 값이 succeeded가 될 때까지 몇 초마다 GET /v1/tasks/{task_id}를 호출합니다.
  3. 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를 보고 정하세요.

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로 주제별 월간 검색 수, 갱신 시점, 그 아래 추천된 세부 주제를 읽어 옵니다.

다른 플랫폼 둘러보기

Pinterest 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Pinterest User Boards API — 자주 묻는 질문

Pinterest User Boards API는 프로필 URL을 입력받아 공개 Pinterest 프로필의 보드를 나열하는 프로그래밍 인터페이스입니다. 보드마다 이름, 설명, 커버 이미지, 소유자, 생성일, 공동 보드 여부와 핀·팔로워·섹션·협업자 수를 반환합니다.

계정의 프로필 링크를 urls 배열에 넣고 results_limit 값을 보드 수 이상으로, 최대 500까지 설정하세요. 보드마다 이름, url, 각종 수치가 담긴 별도 행으로 반환됩니다.

각 행은 보드 자체를 설명하며, 보드에 담긴 핀 수는 metrics.pins_count 값으로 제공됩니다. 핀을 읽으려면 보드의 url 값을 Pinterest Board Pins API에 보내세요.

공동 보드(그룹 보드)는 소유자 외의 계정도 핀을 추가할 수 있는 보드입니다. 이런 보드는 is_collaborative 값이 true이고, metrics.collaborators_count 값에 협업자 수가 담깁니다.

보드 하나당 0.5 크레딧이므로 기본 제한 25개로 프로필 3개를 조회하면 최대 37.5 크레딧입니다. 보드가 제한보다 적은 프로필은 실제로 반환된 보드만큼만 청구됩니다.