100 크레딧 무료, 카드 등록 없이지금 시작하기
Logo
무료로 시작하기
Pinterest logoPinterest API

공개 Pinterest 데이터 API

SocialCrawl API 키로 공개 Pinterest 데이터를 구조화 JSON으로 가져옵니다. Post, Comment, Author 스키마는 다른 플랫폼과 같습니다. 호출은 크레딧으로 과금됩니다.

문서 보기동작 방식직접 호출
Pinterest logo
/v1/pinterest

활성 엔드포인트는 5개입니다.

  • GET /v1/pinterest/user/boards
  • GET /v1/pinterest/board
  • GET /v1/pinterest/pin
  • GET /v1/pinterest/search
  • GET /v1/pinterest/url-stats

Pinterest 엔드포인트

공개 Pinterest 읽기 엔드포인트는 5개입니다. 보드, 핀, 검색, URL 통계를 제공합니다. 데이터 API만 지원합니다.

사용자 보드

1 크레딧
/v1/pinterest/user/boards

공개 사용자 보드 데이터를 반환합니다. 본문, 참여 지표, 작성자 필드가 포함됩니다.

handle, trim

보드

1 크레딧
/v1/pinterest/board

공개 보드 데이터를 반환합니다. 본문, 참여 지표, 작성자 필드가 포함됩니다.

url, trim

핀

1 크레딧
/v1/pinterest/pin

공개 핀 데이터를 반환합니다. 본문, 참여 지표, 작성자 필드가 포함됩니다.

url, trim

검색

1 크레딧
/v1/pinterest/search

공개 검색 결과를 반환합니다. 제목, 스니펫 또는 게시물 행이 포함됩니다.

query, cursor, trim

URL 통계

1 크레딧
/v1/pinterest/url-stats

공개 URL 통계 데이터를 반환합니다. 필드는 레지스트리 스키마를 따릅니다.

urls

Pinterest API5개 엔드포인트 지원
문서 보기

키워드와 맞는 Pinterest 핀을 돌려줍니다. 제목과 이미지 URL, 저장 수, 작성자 정보, 소속 보드가 함께 담깁니다.

주제로 핀을 훑을 때 사용하세요. 핀 URL이 이미 있다면 더 자세한 pin을 쓰세요.

1크레딧

GET/v1/pinterest/search?query=home+decor+ideas

query · Search query

$ curl https://www.socialcrawl.dev/v1/pinterest/search?query=home+decor+ideas \
    -H "x-api-key: sc_YOUR_API_KEY"
대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다

Pinterest API 동작 방식

Pinterest도 다른 SocialCrawl 소셜 엔드포인트와 같습니다. API 키로 GET /v1/pinterest/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다. 별도 SDK는 없습니다.

호출 인증

x-api-key 헤더에 키를 보냅니다. SocialCrawl 카탈로그 전 구간에 같은 키를 사용합니다.

GET과 쿼리 파라미터

라우트는 GET입니다. handle, url, query, cursor를 쿼리로 전달합니다. 과금 전에 형식을 검증합니다.

크레딧 과금

라이브 미스는 라우트 티어를 차감합니다. 캐시 히트는 0입니다. 빈 응답과 하드 실패는 환불됩니다.

JSON 봉투

응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다.

연동 순서

대부분 제품은 계정을 확인한 뒤 목록을 보고 필요한 게시물만 깊게 읽습니다.

01계정
GET /v1/pinterest/user/boards

Author 형태 프로필입니다.

핸들 또는 id를 한 번 확정합니다.

02목록
GET /v1/pinterest/board

최근 공개 항목의 PostList입니다.

라우트가 지원하면 cursor 또는 after로 페이지를 넘깁니다.

03항목
GET /v1/pinterest/pin

URL 또는 id 기준 전체 Post입니다.

목록 행만으로 부족할 때 사용합니다.

04댓글
GET /v1/pinterest/search

플랫폼이 제공하는 CommentList입니다.

스레드가 중요할 때만 확장합니다.

요청
GET /v1/pinterest/user/boards
  ?handle=pinterest
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
응답 봉투
{
  "success": true,
  "data": { "/* Author | Post | PostList | CommentList | … */": true },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

data 형태

archetype이 맞으면 필드 이름은 SocialCrawl 나머지 플랫폼과 같습니다.

Authoruser/boards

id, username, display_name, avatar_url, bio, followers, url, ext

PostList / Postboard

items[].post에 id, url, content, engagement, author, published_at, ext

CommentListpin

댓글 라우트가 있을 때 items[]에 author, content.text, engagement, published_at

Search / Mediasearch

검색 결과, 미디어 메타데이터, 대본 등 라우트별 필드

게이트웨이 내부

다른 /v1 플랫폼 엔드포인트와 같은 요청 수명 주기입니다.

  1. 01

    엣지 수신

    Next.js catch-all이 Hono 소셜 API로 연결됩니다. request_id를 발급하고 키를 인증한 뒤 속도 제한과 동시성을 적용합니다.

  2. 02

    검증 후 차감

    레지스트리에서 라우트를 찾습니다. 필수 파라미터를 먼저 검사합니다. 잘못된 입력은 미과금 400입니다. 유효 호출은 upstream 전에 차감합니다.

  3. 03

    캐시 또는 수집

    platform + resource + params로 캐시 키를 만듭니다. 히트는 credits_used 0입니다. 미스는 재시도와 서킷 브레이커로 upstream을 호출합니다.

  4. 04

    정규화 후 반환

    upstream JSON을 Author / Post / PostList / CommentList(또는 라우트 archetype)로 매핑하고 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.

운영에서 중요한 과금 규칙

  • 표준 라이브 미스: 티어 비용(보통 1 크레딧)
  • 고급 읽기: 보통 5 크레딧
  • 프리미엄 읽기: 보통 10 크레딧
  • 종량제 라우트: 문서화된 최소 바닥
  • 캐시 히트: 0 크레딧
  • 빈 응답·하드 실패: 자동 환불
  • 잘못된 파라미터: 400, 미과금
  • 크레딧 부족: 402, 미과금
  • 비활성 라우트: 503, 미과금

데이터 수집 방식

Pinterest은 SocialCrawl의 공개 읽기 데이터입니다. 공유 스키마로 정규화하므로 별도 OAuth를 배울 필요가 없습니다.

이 API에서의 Pinterest

레지스트리에 노출된 공개 Pinterest 표면입니다. 연구·모니터링·제품 작업을 위한 읽기 전용입니다.

SocialCrawl 접근 방식

하나의 게이트웨이 뒤에서 소셜 읽기 upstream을 호출합니다. 등록된 두꺼운 라우트는 Prism 컴포지트로 단계를 묶습니다.

엣지에서 나가는 형태

success, data, credits_used, request_id, cached 통일 JSON 봉투입니다. Author / Post / Comment 리프를 공유합니다.

제공하지 않는 범위

쓰기 엔드포인트와 비공개 수신함은 없습니다. 비활성 라우트는 활성 개수에 넣지 않습니다.

필드 매핑
upstream identity→ author.* / data root프로필 식별자와 카운터
public post / media→ post.* / items[].post게시물 본문과 참여 지표
list / search page→ items[] or hits댓글 또는 검색 결과

이 API의 활용 분야

이 API가 가장 많이 사용되는 작업입니다.

5active Pinterest endpoints in the registry
1 / 5 / 10표준·고급·프리미엄 크레딧 단계

Pinterest 모니터링과 콘텐츠 분석

호출은 Pinterest 프로필, 콘텐츠 목록, 검색, 심화 경로에 집중됩니다. 공유 스키마의 구조화 Pinterest JSON과 SocialCrawl API 키 하나입니다.

상세 읽기는 캐시 미스 기준 수 초 수준입니다. 검색과 두꺼운 컴포지트는 더 느린 경로입니다.

Pinterest API 활용 사례

Pinterest 데이터가 가장 많이 쓰이는 작업입니다. 각 항목에서 엔드포인트 순서와 과금 방식을 확인합니다.

활용 사례

이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.

모니터링 잡

Python, cron, Slack 봇

Pinterest 프로필과 피드를 폴링합니다. 참여 속도가 뛰면 알립니다.

리서치·VoC

Node, 노트북, BI 적재

Pinterest에서 검색 후 게시물을 확장해 브랜드·제품·경쟁 언어를 모읍니다.

백엔드 제품 잡

Go, 워커, Explorer

해석-목록-상세를 파이프라인에 연결합니다. 캐시 히트로 반복 비용을 낮춥니다.

두 줄로 호출

라이브 미스는 티어별 크레딧을 사용합니다. 캐시 히트는 무료입니다. 빈 응답과 하드 실패는 환불됩니다.

curl "https://www.socialcrawl.dev/v1/pinterest/user/boards?handle=pinterest" \
  -H "x-api-key: sc_your_api_key_here"
curl "https://www.socialcrawl.dev/v1/pinterest/board?url=https://www.pinterest.com/lizmrodgers/moms-night/" \
  -H "x-api-key: sc_your_api_key_here"
Pinterest logoSocialCrawl의 Pinterest

카탈로그 전 구간과 같은 키

플랫폼 문서API 키 받기
엔드포인트

Pinterest API는 어떤 데이터를 돌려주나요

모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.

SearchSearch Pinterest pinsPinGet Pinterest pin detailsUrl StatsGet Pinterest save counts for external URLsBoardGet Pinterest boardUser BoardsList Pinterest user boards
비교

SocialCrawl과 공식 Pinterest API, 뭐가 다른가요?

같은 Pinterest 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.

인증 방식

SocialCrawl
x-api-key 헤더 하나면 돼요
공식 Pinterest API
OAuth 2.0 액세스·리프레시 토큰을 직접 관리해야 해요

시작 절차

SocialCrawl
앱 심사 없이 가입 후 바로 호출할 수 있어요
공식 Pinterest API
개발자 앱 등록과 대부분 스코프에 대한 승인 심사를 거쳐야 해요

레이트 리밋

SocialCrawl
크레딧 잔액만 신경 쓰면 돼요
공식 Pinterest API
앱 단위 레이트 리밋을 직접 관리해야 해요

응답 스키마

SocialCrawl
51개 플랫폼이 같은 통합 JSON 스키마를 써요
공식 Pinterest API
Pinterest 전용 응답 형식이에요

요금

SocialCrawl
호출당 1 크레딧, 가입 시 100 크레딧 무료예요
공식 Pinterest API
무료지만 승인된 앱과 스코프 안에서만 쓸 수 있어요

데이터 범위

SocialCrawl
키워드 검색, 핀, 보드, 사용자 보드, URL 저장 수까지 읽을 수 있어요
공식 Pinterest API
내 콘텐츠와 광고 관리 중심이에요

유지보수

SocialCrawl
업스트림 변경은 SocialCrawl이 흡수해요
공식 Pinterest API
API 버전 변경과 지원 종료를 직접 추적해야 해요
자주 묻는 질문

자주 묻는 질문

API, 요금제, 기능에 대한 질문과 답변입니다.

문의하기
Pinterest 데이터는 어떻게 수집하나요?
SocialCrawl이 키워드 검색, 핀 상세, 보드 핀, 사용자 보드, URL 저장 수까지 Pinterest 엔드포인트 5종을 제공해요. x-api-key만 있으면 OAuth나 Pinterest 개발자 계정 심사 없이 바로 호출할 수 있어요.
SocialCrawl은 어떤 Pinterest 엔드포인트를 지원하나요?
엔드포인트 5종을 쓰실 수 있어요: Search, Pin, URL Stats, Board, and User Boards. 모든 응답이 동일한 통합 스키마로 와요.
Pinterest API는 무료로 쓸 수 있나요?
네, 새 계정에는 100 크레딧이 무료로 제공돼서 신용카드 없이 100건의 Pinterest 호출을 미리 테스트해 보실 수 있어요. Pinterest 엔드포인트는 호출당 1 크레딧(스탠다드 티어)으로 소진돼요.
Pinterest에는 공식 스크래핑 API가 있나요?
Pinterest 공식 API는 비즈니스 계정 승인이 필요하고 광고·전환 추적에 초점이 맞춰져 있어요. SocialCrawl은 핀, 보드, 검색을 위한 스크래핑 API를 제공해서 OAuth나 Pinterest 로그인 없이 x-api-key로 바로 쓸 수 있어요.
Pinterest API는 요금이 얼마인가요?
Pinterest 엔드포인트 5종 모두 호출당 1 크레딧(스탠다드 티어)이 소진돼요. 100 크레딧 무료 체험 후 Starter £15/2.5천 호출부터 종량제로 이어지고, 크레딧은 만료되지 않으며 월 최소 요금이나 호출 제한이 없어요.
Pinterest에서 키워드로 핀을 검색할 수 있나요?
네, search 엔드포인트에 query 파라미터를 보내면 매칭되는 핀의 제목, 이미지 URL, 저장 수, 작성자 정보, 보드 정보가 JSON으로 와요. 비주얼 트렌드 리서치나 콘텐츠 발굴에 쉽고 간편하게 쓸 수 있어요.
가장 좋은 Pinterest 스크래퍼 API는 무엇인가요?
공개 Pinterest 데이터라면 SocialCrawl이 좋은 선택이에요. 검색, 핀, 보드, 사용자 보드, URL 저장 수까지 엔드포인트 5종을 호출당 1 크레딧으로 쓸 수 있고, 가입하면 신용카드 없이 100 크레딧이 무료로 제공돼요. OAuth나 비즈니스 계정 심사 없이 x-api-key 하나로 51개 플랫폼과 같은 통합 JSON을 받아볼 수 있어요.
Pinterest 데이터 스크래핑, 법적으로 괜찮을까요?
SocialCrawl은 누구나 볼 수 있는 공개 Pinterest 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. Pinterest 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.

AI에게 SocialCrawl을 물어보세요

ChatGPT에 물어보기Perplexity에 물어보기Gemini에 물어보기Claude에 물어보기Grok에 물어보기

Pinterest API 레퍼런스 문서 보기

🤖 AI 에이전트나 LLM이신가요? 이 페이지를 markdown으로 읽어보세요