API 목록으로 돌아가기
Pinterest 공개 데이터

Pinterest 공개 데이터 API

공개 Pinterest 프로필 데이터를 가져오고, 알고 있는 핀을 확인하고, 선택한 프로필의 핀을 수집하거나 키워드로 검색해 크리에이터, 콘텐츠, 비주얼 트렌드를 리서치합니다.

사용할 수 있는 Pinterest API

계정 데이터는 Profiles, 알고 있는 핀은 Pins, 선택한 프로필의 콘텐츠는 User Pins, 키워드 기반 핀 탐색은 Search를 사용합니다.

어떤 Pinterest 데이터를 가져올 수 있나요?

SocQ는 식별 정보, 콘텐츠, 미디어, 분류, 탐색, 참여도, 수집 시점 정보가 담긴 정규화된 공개 계정·핀 레코드를 반환합니다.

공개 프로필 상세

프로필 ID, 사용자 이름, 표시 이름, 소개, 이미지, 연결된 웹사이트, 국가 정보, 공개된 계정 수치를 가져옵니다.

핀 콘텐츠와 미디어

핀 식별 정보, 제목, 텍스트, 크리에이터 정보, 미디어 참조, 게시 시각, 제공되는 공개 지표를 가져옵니다.

크리에이터 핀 모음

선택한 프로필 URL의 공개 핀을 범위를 정해 탐색하고, 각 결과를 제출한 프로필과 연결된 상태로 유지합니다.

주제와 분류

키워드로 핀을 검색하고, 제공되는 게시물 유형, 카테고리, 해시태그, 출처 정보, 탐색 입력값을 보존합니다.

SocQ vs Pinterest API

SocQ는 지원하는 공개 Pinterest 데이터 수집에 집중합니다. Pinterest의 공식 API는 인증된 콘텐츠, 광고, 분석, 카탈로그 연동을 위해 설계되었습니다.

기능SocQPinterest API
주요 용도공개 프로필, 핀, 사용자 핀, 검색 결과 수집권한이 부여된 콘텐츠, 광고, 분석, 카탈로그 관리
고객 OAuthSocQ API 키만 사용하며 고객의 Pinterest OAuth 불필요Pinterest 앱, 액세스 토큰, 필요한 스코프
시작 입력공개 프로필 또는 핀 URL, 또는 텍스트 검색어권한이 부여된 계정 컨텍스트와 Pinterest 리소스 ID
핀 생성·관리지원하지 않음쓰기 스코프를 가진 인증된 사용자를 대신해 지원
응답 형식정규화된 SocQ 레코드Pinterest API 고유 객체

Pinterest API 작동 방식

Pinterest API 4종 모두 같은 비동기 작업과 페이지네이션 결과 흐름을 따릅니다.

  1. 1. 입력 제출

    프로필 URL, 핀 URL, 검색어를 알맞은 API에 보내고 반환된 task_id를 저장합니다.

  2. 2. 작업 추적

    처리가 완료될 때까지 /v1/tasks/{task_id}를 폴링합니다.

  3. 3. 결과 가져오기

    data.results.items를 읽고, has_more가 true인 동안 next_cursor를 사용합니다.

키워드로 공개 핀 검색

SocQ API 키로 인증하고 텍스트 검색어를 제출합니다. Profiles, Pins, User Pins도 같은 작업 흐름을 따릅니다.

curl -X POST "https://api.socq.ai/v1/pinterest/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"home office ideas","results_limit":100}'

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

Pinterest API 주요 활용 사례

크리에이터·프로필 리서치

알고 있는 프로필 URL에 공개 식별 정보, 소개, 웹사이트, 국가 정보, 공개된 수치, 수집 시각을 추가합니다.

알고 있는 핀 분석

선택한 핀 URL을 콘텐츠, 크리에이터, 미디어, 분류 체계, 타임스탬프, 공개 지표, 출처 링크로 변환합니다.

크리에이터 콘텐츠 모니터링

선택한 프로필에서 범위를 정해 핀 세트를 수집하고, 수집 시점의 콘텐츠와 계정 스냅샷을 비교합니다.

비주얼 주제·트렌드 리서치

정해 둔 키워드를 검색해 크리에이터, 미디어, 분류, 탐색 정보가 담긴 구조화된 핀 데이터셋을 구축합니다.

제한 사항과 공개 데이터 정책

Pinterest 결과는 특정 시점의 공개 레코드입니다. 이 API들은 비공개 콘텐츠에 접근하지 않으며, 프로필과 핀을 생성·수정·저장·관리하지 않습니다.

  • Profiles에는 사용자 이름 경로 세그먼트가 하나인 프로필 URL이 필요합니다. 보드, 핀, 오디언스 구성원 목록이 아니라 계정 상세 정보를 반환합니다.
  • Pins에는 알고 있는 공개 /pin/{id} URL이나 pin.it 링크가 필요하며, 프로필을 핀 모음으로 확장하지 않습니다.
  • User Pins에는 공개 프로필 URL이 필요합니다. results_limit의 기본값은 100이고 1~2,000을 받으며, 프로필마다 따로 적용됩니다.
  • Search에는 텍스트 검색어 하나가 필요합니다. results_limit의 기본값은 100이고 1~2,000을 받으며, 정렬과 추가 필터는 제공하지 않습니다.
  • 공개 원본에서 노출하지 않는 경우 선택 항목인 식별 정보, 콘텐츠, 미디어, 분류, 출처, 타임스탬프, 지표 필드는 null이거나 비어 있을 수 있습니다.
  • 이 API는 읽기 전용이며 Pinterest 프로필, 보드, 핀을 생성·수정·저장·관리하지 않습니다.

Pinterest API 자주 묻는 질문

Pinterest API란 무엇인가요?

Pinterest API는 공개 프로필 데이터를 가져오고, 알고 있는 핀을 확인하고, 선택한 프로필의 핀을 수집하고, 키워드로 공개 핀을 검색하는 SocQ 엔드포인트 모음입니다.

어떤 Pinterest API를 사용해야 하나요?

계정 상세 정보는 Profiles, 알고 있는 /pin/{id} 또는 pin.it 링크는 Pins, 프로필 URL에서 범위를 정해 수집할 때는 User Pins, 키워드 기반 탐색은 Search를 사용하세요.

Profiles와 User Pins는 같은 데이터를 반환하나요?

아니요. Profiles는 계정 메타데이터와 집계 수치를 반환하고, User Pins는 제출한 프로필 URL에서 찾은 정규화된 핀 레코드를 반환합니다.

User Pins의 결과 상한은 어떻게 적용되나요?

results_limit의 기본값은 100이고 1부터 2,000까지의 정수를 받으며, 프로필 URL마다 따로 적용됩니다.

필드가 null이거나 비어 있는 이유는 무엇인가요?

수집 시점에 공개 프로필이나 핀이 식별 정보, 콘텐츠, 미디어, 분류 체계, 출처, 타임스탬프, 지표 값을 모두 노출하지는 않을 수 있기 때문입니다.

Pinterest 수집 요금은 어떻게 되나요?

반환된 프로필과 Search 핀은 1건당 0.6 크레딧, Pins나 User Pins에서 반환된 핀은 1건당 0.5 크레딧입니다. 빈 결과에는 결과 요금이 부과되지 않습니다.

여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.