Pinterest Topic
Pinterest 주제는 홈 데코처럼 하나의 테마로 핀을 묶은 아이디어 페이지로, Pinterest가 집계한 월간 검색 수, 그 수치가 갱신된 날짜, 크리스마스나 빈티지 중고 같은 세부 주제 묶음이 함께 표시됩니다. 수치는 그 테마가 Pinterest에서 얼마나 수요를 모으는지 보여 주고 세부 주제는 사람들이 함께 찾는 스타일, 시즌, 소재를 알려 주므로 키워드 리서치와 콘텐츠 기획의 기초 자료가 됩니다.
Pinterest Topic API 주요 기능
- 주제별 월간 검색 수search_count 값은 Pinterest가 해당 주제에 대해 집계한 월간 검색 수로, 사람들이 그 주제를 얼마나 자주 찾는지 직접 보여 줍니다.
- 링크가 붙은 세부 주제related_topics 배열에는 Pinterest가 추천하는 하위 주제가 전체 이름, DIY 같은 짧은 라벨, 해당 아이디어 페이지 url과 함께 담깁니다.
- 수치의 갱신 시점updated_at 값은 Pinterest가 주제를 마지막으로 갱신한 때를 기록하므로 검색 수가 얼마나 최신인지 알 수 있습니다.
- 요청 하나에 여러 주제urls 배열에 아이디어 페이지를 여러 개 넣을 수 있고, 각 페이지는 주소 속 주제 id를 키로 정확히 한 행씩 반환됩니다.
Pinterest Topic API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | https://www.pinterest.com/ideas/home-decor/935249274030/처럼 숫자 id까지 포함한 /ideas/{topic}/{id}/ 형식의 Pinterest 아이디어 페이지 링크입니다. |
Pinterest Topic API 사용 방법
아이디어 페이지 링크를 제출하고 주제마다 한 행씩 받습니다.
- Pinterest에서 아이디어 페이지 링크를 복사해 urls 배열에 넣고 /v1/pinterest/topic으로 POST합니다.
- GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다.
- results.items의 항목마다 주제 하나를 읽고, has_more 값이 true이면 results.next_cursor로 나머지를 가져옵니다.
curl -X POST "https://api.socq.ai/v1/pinterest/topic" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.pinterest.com/ideas/home-decor/935249274030/"]}'
# One row and 0.5 credits per topic.Pinterest Topic API 추천 활용 사례
- 수요 기준 콘텐츠 아이디어 순위: 후보 주제 목록의 search_count 값을 모아, 핀이나 보드를 기획하기 전에 사람들이 가장 많이 찾는 주제부터 다룹니다.
- 넓은 테마 안의 롱테일 각도 찾기: 홈 데코 아래의 Christmas, Thrifted, Earthy Cottage처럼 related_topics의 라벨을 읽고, 오디언스가 분명한 좁은 각도를 고릅니다.
- 자체 Pinterest 수요 이력 관리: 같은 주제를 매달 수집해 search_count 값을 updated_at 값과 함께 저장하고, 테마별 관심도가 시간에 따라 어떻게 움직이는지 차트로 그립니다.
Pinterest Topic API 활용 팁
- 모든 링크에 숫자 id를 남겨 두세요. /ideas/home-decor/935249274030/은 통과하지만 주제 이름에서 끝나는 주소는 검증에 실패합니다.
- related_topics[].url 값을 다음 배치로 제출해 틈새 주제를 한 단계씩 넓히고, 이미 수집한 주제 id는 제외하세요. 갈래를 따라가다 보면 같은 아이디어 페이지로 되돌아오는 경우가 많습니다.
- 주제 간 search_count 값은 반드시 updated_at 값과 함께 비교하세요. 각 수치는 그 주제가 마지막으로 갱신된 시점 기준입니다.
관련 API
Pinterest Topic API 외에 Pinterest의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Pinterest Pins API — 공개 핀 URL을 정규화된 콘텐츠, 크리에이터, 미디어, 분류, 타임스탬프, 공개된 지표로 변환합니다.
- Pinterest User Pins API — 프로필 URL에서 공개 핀을 찾으며, 프로필별 결과 수 제한과 정규화된 콘텐츠, 크리에이터, 미디어, 타임스탬프, 공개된 지표를 포함합니다.
- Pinterest Profiles API — 프로필 URL에서 공개 프로필 정보, 소개, 이미지, 웹사이트, 공개된 계정 수치, 수집 맥락을 수집합니다.
- Pinterest Search API — 텍스트 검색어와 결과 수 제한으로 공개 핀을 검색하고, 정규화된 콘텐츠, 크리에이터, 미디어, 분류, 타임스탬프, 공개된 지표를 반환합니다.
- Pinterest User Boards API — 프로필 URL로 Pinterest 프로필의 보드를 나열하며 이름, 설명, 커버, 생성일과 핀·팔로워·섹션·협업자 수를 포함합니다.
- Pinterest Board Pins API — 보드 URL로 Pinterest 보드의 핀을 보드 순서대로 수집하며 핀 텍스트, 저장한 계정, 원본 이미지, 핀 링크를 포함합니다.