Pinterest Profiles
Pinterest 프로필은 사용자 이름, 표시 이름, 소개, 프로필 이미지, 연결된 웹사이트, 공개된 팔로워·팔로잉·보드·저장 수를 담은 공개 계정 페이지입니다. 이러한 신원 필드와 계정 신호는 프로필 정보 보강, 공개 계정 비교, 시점별 모니터링에 활용할 수 있습니다.
Pinterest Profiles API 주요 기능
- 공개 프로필 URL 범위지원되는 Pinterest 프로필 URL을 하나 이상 처리하며, 핀 링크, 단축 링크, 검색 페이지 등 프로필이 아닌 경로는 제외합니다.
- 프로필 신원과 표시 정보프로필 ID, 정식 URL, 사용자 이름, 표시 이름, 소개, 프로필 이미지, 연결된 웹사이트를 하나의 정규화된 레코드로 반환합니다.
- 공개된 계정 수치사용 가능한 팔로워·팔로잉·보드·저장 수를 계정 단위 비교에 쓸 수 있도록 별도 지표로 보관합니다.
- 수집·원본 정보collected_at과 함께 사용 가능한 국가 코드, 생성한 핀 페이지 URL, 원본 업데이트 값, 탐색 입력을 신원 필드와 섞지 않고 덧붙입니다.
Pinterest Profiles API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 공개 Pinterest 프로필 URL의 목록으로, 필수 값입니다. 각 URL은 Pinterest 도메인의 HTTP 또는 HTTPS를 사용해야 하며, 예약되지 않은 사용자 이름 경로 세그먼트 하나를 포함해야 합니다. |
Pinterest Profiles API 사용 방법
알고 있는 공개 프로필 URL을 제출하고, 비동기 작업을 추적한 뒤, 정규화된 프로필 레코드를 커서 페이지네이션으로 읽습니다.
- 경로에 사용자 이름 세그먼트 하나만 포함된 공개 Pinterest 프로필 URL을 하나 이상 준비합니다.
- 링크를 urls로 /v1/pinterest/profiles에 제출하고, task_id를 저장합니다.
- 처리가 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽은 뒤, has_more가 true인 동안 next_cursor로 다음 페이지를 요청합니다.
curl -X POST "https://api.socq.ai/v1/pinterest/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.pinterest.com/example/"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is truePinterest Profiles API 추천 활용 사례
- 공개 프로필 정보 보강: 알고 있는 프로필 URL과 연결된 레코드에 사용자 이름, 표시 이름, 소개, 프로필 이미지, 웹사이트, 국가 정보를 추가합니다.
- 계정 규모 비교: 선택한 공개 프로필 집합에서 공개된 팔로워·팔로잉·보드·저장 수를 비교합니다.
- 공개 프로필 모니터링: 신원 필드와 공개 지표를 collected_at과 함께 저장해, 수집 시점별 프로필 표시 내용과 계정 신호를 비교합니다.
Pinterest Profiles API 활용 팁
- 사용자 이름 경로 세그먼트가 하나인 완전한 HTTP 또는 HTTPS Pinterest 프로필 URL을 사용하세요. pin.it, /pin/, /search/ 및 그 밖의 예약 경로는 거부됩니다.
- 제출한 URL을 정규화하고, 반환된 프로필은 id가 있으면 id로, 없으면 안정적인 키인 url로 중복을 제거하세요.
- 소개, 이미지, 웹사이트, 국가 코드, 원본 업데이트 값, 생성한 핀 페이지 URL, 개별 지표는 선택 필드로 취급하세요.
- 이후 실행 결과를 서로 다른 공개 스냅샷으로 구분할 수 있도록, 공개된 계정 수치 옆에 collected_at을 함께 보관하세요.
- 프로필의 핀 레코드가 필요하다면 Pinterest User Pins API를 사용하세요. 이 엔드포인트는 보드, 핀, 오디언스 목록이 아니라 프로필 메타데이터와 수치를 반환합니다.
관련 API
Pinterest Profiles API 외에 Pinterest의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Pinterest Pins API — 공개 핀 URL을 정규화된 콘텐츠, 크리에이터, 미디어, 분류, 타임스탬프, 공개된 지표로 변환합니다.
- Pinterest User Pins API — 프로필 URL에서 공개 핀을 찾으며, 프로필별 결과 수 제한과 정규화된 콘텐츠, 크리에이터, 미디어, 타임스탬프, 공개된 지표를 포함합니다.
- Pinterest Search API — 텍스트 검색어와 결과 수 제한으로 공개 핀을 검색하고, 정규화된 콘텐츠, 크리에이터, 미디어, 분류, 타임스탬프, 공개된 지표를 반환합니다.
- Pinterest User Boards API — 프로필 URL로 Pinterest 프로필의 보드를 나열하며 이름, 설명, 커버, 생성일과 핀·팔로워·섹션·협업자 수를 포함합니다.
- Pinterest Board Pins API — 보드 URL로 Pinterest 보드의 핀을 보드 순서대로 수집하며 핀 텍스트, 저장한 계정, 원본 이미지, 핀 링크를 포함합니다.
- Pinterest Topic API — Pinterest 아이디어 페이지 URL로 주제별 월간 검색 수, 갱신 시점, 그 아래 추천된 세부 주제를 읽어 옵니다.