pinterest/
pins

핀 URL 또는 pin.it 링크에서 공개 Pinterest 핀을 수집하고, 콘텐츠, 크리에이터 정보, 미디어, 타임스탬프, 공개된 지표를 정규화된 레코드로 반환합니다.

Pinterest Pins API

핀 URL 입력
크리에이터·미디어 정보
공개 지표 스냅샷
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Pinterest Pins

Pinterest 핀은 제목, 설명, 크리에이터 정보, 이미지·동영상 참조, 카테고리, 해시태그, 공개된 참여 수치를 갖춘 공개 비주얼 게시물입니다. 이러한 레코드는 선별한 콘텐츠의 아카이빙, 크리에이티브·주제 조사, 출처 표기, 수집 시점 비교에 활용할 수 있습니다.

Pinterest Pins API 주요 기능

  • 핀 URL과 단축 링크공개 Pinterest /pin/{id} URL 또는 pin.it 단축 링크를 하나 이상 처리하며, 수집 범위는 제출한 핀으로 한정됩니다.
  • 연결된 콘텐츠·크리에이터 필드핀 제목과 텍스트를 원본 URL, 공개 크리에이터 정보, 프로필 URL, 정규화된 이미지·동영상 참조와 함께 반환합니다.
  • 관찰 시점이 있는 공개 지표사용 가능한 좋아요·댓글 수와 크리에이터의 팔로워 수를 collected_at과 함께 보관해, 바뀔 수 있는 공개 값의 스냅샷 시점을 분명히 합니다.
  • 핀 분류 정보사용 가능한 post_type, 카테고리, 해시태그를 핀 텍스트에 합치지 않고 extra에 보존해 형식·주제 분석에 쓸 수 있습니다.

Pinterest Pins API 매개변수

매개변수필수설명
urls필수공개 Pinterest /pin/{id} URL 또는 pin.it 단축 링크의 목록으로, 필수 값입니다. 그 외 Pinterest 경로와 Pinterest가 아닌 호스트는 거부됩니다.

Pinterest Pins API 사용 방법

필요한 공개 핀을 정확히 지정해 제출하고, 비동기 작업을 추적한 뒤, 정규화된 핀 레코드를 커서 페이지네이션으로 읽습니다.

  1. 공개 Pinterest /pin/{id} URL 또는 pin.it 단축 링크를 하나 이상 준비합니다.
  2. 링크를 urls로 /v1/pinterest/pins에 제출하고, task_id를 저장합니다.
  3. 처리가 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽은 뒤, has_more가 true인 동안 next_cursor로 다음 페이지를 요청합니다.
curl -X POST "https://api.socq.ai/v1/pinterest/pins" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.pinterest.com/pin/123456789/"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Pinterest Pins API 추천 활용 사례

  • 선별한 핀 아카이빙: 정해 둔 URL 목록에 대해 핀 ID, 원본 URL, 제목, 텍스트, 크리에이터 필드, 미디어 참조, 게시 시각을 보존합니다.
  • 크리에이티브·주제 검토: 미디어 유형, post_type, 카테고리, 해시태그, 제목, 텍스트를 활용해 선택한 핀의 형식과 주제를 비교합니다.
  • 수집 시점 신호 비교: 공개된 좋아요·댓글 수를 크리에이터의 팔로워 정보와 함께 비교하고, collected_at으로 각 관찰 시점을 고정합니다.

Pinterest Pins API 활용 팁

  • 항목마다 공개 /pin/{id} URL 또는 pin.it 링크를 사용하세요. 프로필, 검색, 아이디어 등 다른 Pinterest 경로는 이 엔드포인트의 입력 규칙에 맞지 않습니다.
  • 직접 링크와 단축 링크가 같은 핀으로 연결될 수 있으므로, 반환된 id 값으로 중복을 제거하세요.
  • 공개 핀이 모든 값을 노출하지는 않으므로 media, created_at, categories, hashtags, post_type, 개별 지표는 선택 필드로 취급하세요.
  • 이후 실행 결과를 서로 다른 수집 시점의 스냅샷으로 해석할 수 있도록, 공개 지표 옆에 collected_at을 저장하세요.

Pinterest Pins API 외에 Pinterest의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Pinterest User Pins API — 프로필 URL에서 공개 핀을 찾으며, 프로필별 결과 수 제한과 정규화된 콘텐츠, 크리에이터, 미디어, 타임스탬프, 공개된 지표를 포함합니다.
  • Pinterest Profiles API — 프로필 URL에서 공개 프로필 정보, 소개, 이미지, 웹사이트, 공개된 계정 수치, 수집 맥락을 수집합니다.
  • Pinterest Search API — 텍스트 검색어와 결과 수 제한으로 공개 핀을 검색하고, 정규화된 콘텐츠, 크리에이터, 미디어, 분류, 타임스탬프, 공개된 지표를 반환합니다.
  • Pinterest User Boards API — 프로필 URL로 Pinterest 프로필의 보드를 나열하며 이름, 설명, 커버, 생성일과 핀·팔로워·섹션·협업자 수를 포함합니다.
  • Pinterest Board Pins API — 보드 URL로 Pinterest 보드의 핀을 보드 순서대로 수집하며 핀 텍스트, 저장한 계정, 원본 이미지, 핀 링크를 포함합니다.
  • Pinterest Topic API — Pinterest 아이디어 페이지 URL로 주제별 월간 검색 수, 갱신 시점, 그 아래 추천된 세부 주제를 읽어 옵니다.

다른 플랫폼 둘러보기

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

Pinterest Pins API — 자주 묻는 질문

Pinterest Pins API는 제출한 Pinterest 핀 URL 또는 지원되는 단축 링크에서 공개 핀 레코드를 가져옵니다. 정규화된 콘텐츠, 크리에이터 정보, 미디어, 타임스탬프, 카테고리, 해시태그, 공개된 지표를 반환합니다.

경로가 /pin/{id}로 시작하는 Pinterest 도메인의 HTTP 또는 HTTPS URL을 제출하거나, pin.it 단축 링크를 사용하세요. 프로필, 검색, 아이디어 등 다른 경로는 거부됩니다.

아니요. urls에 담긴 지원되는 공개 핀 링크만 처리하며, 크리에이터 프로필을 피드로 확장하지는 않습니다.

정규화된 media 배열에는 공개 이미지 또는 동영상 참조가 들어갈 수 있습니다. 원본 레코드에 사용할 수 있는 미디어 URL이 없으면 비어 있습니다.

공개 핀이 미디어, 게시 시각, 카테고리, 해시태그, 게시물 유형 또는 모든 공개 지표를 노출하지 않을 수 있어서, 선택 값은 null 또는 빈 값일 수 있습니다.

완료된 결과에 포함된 핀 레코드 1건당 0.5 SocQ 크레딧이 차감됩니다. 빈 결과에는 결과 요금이 없습니다.