pinterest/
topic

아이디어 페이지 URL로 Pinterest 주제를 조회하며, 주제마다 이름, Pinterest가 집계한 월간 검색 수, 갱신 시점, 추천 세부 주제를 반환합니다.

Pinterest Topic API

아이디어 페이지 URL 입력
월간 검색 수
링크가 붙은 관련 주제
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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

아이디어 페이지 링크를 제출하고 주제마다 한 행씩 받습니다.

  1. Pinterest에서 아이디어 페이지 링크를 복사해 urls 배열에 넣고 /v1/pinterest/topic으로 POST합니다.
  2. GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다.
  3. 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 값과 함께 비교하세요. 각 수치는 그 주제가 마지막으로 갱신된 시점 기준입니다.

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 보드의 핀을 보드 순서대로 수집하며 핀 텍스트, 저장한 계정, 원본 이미지, 핀 링크를 포함합니다.

다른 플랫폼 둘러보기

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

Pinterest Topic API — 자주 묻는 질문

Pinterest Topic API는 아이디어 페이지 URL로 Pinterest 주제 정보를 읽어 오는 프로그래밍 인터페이스입니다. 주제마다 이름, Pinterest가 집계한 월간 검색 수, 그 수치의 최근 갱신 시점, 그 아래에 추천된 세부 주제를 반환합니다.

주제마다 Pinterest가 집계한 현재 월간 검색 수를 갱신 시점과 함께 제공합니다. 같은 주제를 정기적으로 수집하면 직접 차트로 그릴 수 있는 이력이 쌓입니다.

아이디어 페이지는 pinterest.com/ideas/ 아래에 있고 /ideas/home-decor/935249274030/처럼 숫자 id로 끝납니다. 모든 행에는 이미 허용되는 형식으로 된 related_topics[].url 값도 함께 반환됩니다.

name 값은 Christmas Home Decor 같은 전체 주제 이름이고, label 값은 Christmas처럼 Pinterest가 그 주제에 표시하는 짧은 태그입니다.

반환된 주제 하나당 0.5 크레딧이므로, 아이디어 페이지 10개를 확인하면 5 크레딧입니다.