플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Pinterest 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | 키워드로 Pinterest 핀을 검색합니다. | 요청 1,000개당 $1.39 | 정상 |
프로필profile | 핸들(@ 포함 여부 무관)로 Pinterest 계정을 조회해 소개, 웹사이트, 인증 여부, 비공개 플래그, 팔로워·핀·보드·동영상 수를 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
사용자 게시물user_posts | Pinterest 계정이 게시한 핀을 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
핀 상세 정보pin | 숫자 ID가 포함된 /pin/ 링크로 Pinterest 핀 하나를 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
보드boards | Pinterest 계정이 소유한 보드를 나열하며, 설명, 커버 이미지, 핀 수와 섹션 수, 팔로워 수, 공개 범위 설정, 공동 작업 여부 플래그를 제공합니다. | 요청 1,000개당 $1.39 | 정상 |
보드의 핀board_pins | board_id(예: pinterest/official-news)로 Pinterest 보드 하나에 저장된 핀을 살펴봅니다. | 요청 1,000개당 $1.39 | 정상 |
보드 상세 정보board_detail | 보드 url로 Pinterest 보드를 확인합니다. | 요청 1,000개당 $1.39 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Pinterest 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 키워드로 Pinterest 핀을 검색합니다. 전체 핀 또는 동영상 핀만 대상으로 할 수 있으며, 이미지, 출처 도메인, 주요 색상, 반응 수, 보드, 핀을 저장한 사용자 정보를 제공합니다. 보드나 크리에이터 자체는 검색 결과로 반환되지 않으며, 핀이 이미지에 대한 권리를 부여하거나 링크된 사이트를 보증하지는 않습니다. | keyword | content_type | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · title · text · image_url · reaction_count · source_domain · dominant_color · posted_at · author_username · author_name · author_follower_count · board_name · platform |
profile프로필 핸들(@ 포함 여부 무관)로 Pinterest 계정을 조회해 소개, 웹사이트, 인증 여부, 비공개 플래그, 팔로워·핀·보드·동영상 수를 가져옵니다. 프로필 URL은 허용되지 않으며, 표시된 웹사이트가 도메인 소유를 증명하거나 비밀 보드를 공개하지는 않습니다. | username | — | Sync 응답 | — | 요청 1,000개당 $1.39 | user_id · username · name · bio · avatar_url · follower_count · following_count · pin_count · board_count · video_count · website · is_verified · is_private · created_at · platform |
user_posts사용자 게시물 Pinterest 계정이 게시한 핀을 가져옵니다. 이미지, 동영상, 외부 링크는 구분되어 제공되며, 각각 리핀 수, 반응 수, 댓글 수와 소속 보드가 포함됩니다. 모든 보드와 오래된 핀까지 포함된다는 보장은 없습니다. | username | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · title · text · image_url · video_url · media_type · external_link · source_domain · reaction_count · repin_count · comment_count · share_count · dominant_color · alt_text · posted_at · author_username · author_name · board_name · price · platform |
pin핀 상세 정보 숫자 ID가 포함된 /pin/ 링크로 Pinterest 핀 하나를 가져옵니다. 미디어, 외부 링크와 도메인, 대체 텍스트, 주요 색상, 보드, 반응 수를 받을 수 있습니다. 보드 링크는 여기서 허용되지 않습니다. 외부 사이트는 크롤링하지 않으며 라이선스도 부여되지 않습니다. | url | — | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · title · text · image_url · video_url · media_type · external_link · source_domain · reaction_count · repin_count · comment_count · share_count · dominant_color · alt_text · posted_at · author_username · author_name · board_name · price · platform |
boards보드 Pinterest 계정이 소유한 보드를 나열하며, 설명, 커버 이미지, 핀 수와 섹션 수, 팔로워 수, 공개 범위 설정, 공동 작업 여부 플래그를 제공합니다. 공동 작업 보드라도 모든 참여자나 비공개 콘텐츠는 공개되지 않습니다. | username | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · name · url · description · pin_count · section_count · follower_count · cover_image_url · is_collaborative · privacy · owner_username · owner_name · created_at · platform |
board_pins보드의 핀
| board_id | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · title · text · image_url · video_url · media_type · external_link · source_domain · reaction_count · repin_count · comment_count · share_count · dominant_color · alt_text · posted_at · author_username · author_name · board_name · price · platform |
board_detail보드 상세 정보 보드 | url | — | Sync 응답 | — | 요청 1,000개당 $1.39 | id · name · url · description · pin_count · section_count · follower_count · cover_image_url · is_collaborative · privacy · owner_username · owner_name · created_at · platform |
Pinterest search 파라미터는 각각 무엇을 의미하나요?
키워드로 Pinterest 핀을 검색합니다. 전체 핀 또는 동영상 핀만 대상으로 할 수 있으며, 이미지, 출처 도메인, 주요 색상, 반응 수, 보드, 핀을 저장한 사용자 정보를 제공합니다. 보드나 크리에이터 자체는 검색 결과로 반환되지 않으며, 핀이 이미지에 대한 권리를 부여하거나 링크된 사이트를 보증하지는 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태keyword필수- search 액션의 검색어 또는 영감 주제를 지정합니다. 반환되는 결과 엔티티 구조는 선택한 content_type에 따라 달라집니다.
content_type선택- 검색 결과를 핀 유형으로 필터링합니다. all_pins_visual_posts는 모든 핀(이미지 핀만이 아님), videos_video_pins는 동영상 핀만 대상으로 합니다. 검색은 핀만 반환하며 보드나 크리에이터는 반환하지 않습니다.허용 값:
all_pins_visual_postsvideos_video_pinsPinterest: 이미지 핀, 동영상 핀, 제품 핀 — Pinterest는 핀을 시각적 북마크로 정의하고 이미지, 동영상, 제품 같은 형식을 구분합니다. 이는 콘텐츠 객체를 설명하기 위한 것이며, 검색이 모든 공식 객체나 미디어 필드를 반환한다는 뜻은 아닙니다. 이 페이지의 검색 유형 충돌에는 위의 제한 사항이 계속 적용됩니다. · 확인일
Pinterest profile 파라미터는 각각 무엇을 의미하나요?
핸들(@ 포함 여부 무관)로 Pinterest 계정을 조회해 소개, 웹사이트, 인증 여부, 비공개 플래그, 팔로워·핀·보드·동영상 수를 가져옵니다. 프로필 URL은 허용되지 않으며, 표시된 웹사이트가 도메인 소유를 증명하거나 비밀 보드를 공개하지는 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- profile, user_posts, boards 액션에 사용할 Pinterest 사용자 핸들을 지정하며, 앞의 @는 붙여도 되고 생략해도 됩니다. 프로필 페이지의 전체 URL은 허용되지 않습니다.
Pinterest user_posts 파라미터는 각각 무엇을 의미하나요?
Pinterest 계정이 게시한 핀을 가져옵니다. 이미지, 동영상, 외부 링크는 구분되어 제공되며, 각각 리핀 수, 반응 수, 댓글 수와 소속 보드가 포함됩니다. 모든 보드와 오래된 핀까지 포함된다는 보장은 없습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- profile, user_posts, boards 액션에 사용할 Pinterest 사용자 핸들을 지정하며, 앞의 @는 붙여도 되고 생략해도 됩니다. 프로필 페이지의 전체 URL은 허용되지 않습니다.Pinterest: 저장된 핀이 계정의 오리지널 콘텐츠라는 보장은 없다 — 공식 문서에 따르면 이미지 핀은 이미지를 업로드하거나 외부 사이트 이미지를 저장해 만들 수 있으며, 외부 사이트에서 저장한 핀에는 원본 사이트 링크가 유지됩니다. 계정과 연결된 핀을 곧바로 원작으로 볼 수 없으며, 출처를 확인했다고 해서 콘텐츠 이용 권한이 생기지는 않습니다. · 확인일
Pinterest pin 파라미터는 각각 무엇을 의미하나요?
숫자 ID가 포함된 /pin/ 링크로 Pinterest 핀 하나를 가져옵니다. 미디어, 외부 링크와 도메인, 대체 텍스트, 주요 색상, 보드, 반응 수를 받을 수 있습니다. 보드 링크는 여기서 허용되지 않습니다. 외부 사이트는 크롤링하지 않으며 라이선스도 부여되지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- Pinterest 요청의 대상 URL을 지정합니다. pin 액션에는 /pin/NUMERIC_ID/가 포함된 핀 URL이 필요하고, board_detail에는 /username/boardname/ 형식(또는 상대 경로)의 보드 링크가 필요합니다. 핀 URL 대신 보드 URL을 사용할 수 없습니다.Pinterest: 제품 핀의 판매처 링크 — 공식 문서에 따르면 제품 핀은 사용자를 판매처 웹사이트로 연결할 수 있으며, 일부 리치 핀은 제품 정보를 동기화합니다. 이 페이지는 실제로 가져온 핀 필드만 반환하며, 실시간 재고 정보나 주문 기능, 거래 데이터를 제공한다고 보장하지 않습니다. · 확인일
Pinterest boards 파라미터는 각각 무엇을 의미하나요?
Pinterest 계정이 소유한 보드를 나열하며, 설명, 커버 이미지, 핀 수와 섹션 수, 팔로워 수, 공개 범위 설정, 공동 작업 여부 플래그를 제공합니다. 공동 작업 보드라도 모든 참여자나 비공개 콘텐츠는 공개되지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- profile, user_posts, boards 액션에 사용할 Pinterest 사용자 핸들을 지정하며, 앞의 @는 붙여도 되고 생략해도 됩니다. 프로필 페이지의 전체 URL은 허용되지 않습니다.Pinterest: 보드와 보드 섹션의 계층 구조 — Pinterest는 보드 섹션으로 보드 안의 핀을 정리합니다. 따라서 `section_count`를 보드 수로 취급하면 안 됩니다. 섹션 만들기 튜토리얼을 참조한다고 해서 이 엔드포인트가 콘텐츠를 만들거나 옮기거나 편집할 수 있다는 뜻은 아닙니다. · 확인일
Pinterest board_pins 파라미터는 각각 무엇을 의미하나요?
board_id(예: pinterest/official-news)로 Pinterest 보드 하나에 저장된 핀을 살펴봅니다. 각 핀에는 미디어, 외부 링크, 작성자, 반응 지표가 포함됩니다. 비공개 섹션은 제외되며, 보드 전체를 가져온다는 보장은 없습니다.
board_id필수- board_pins에 사용할 보드 식별자로, 보드 URL에서 pinterest.com/ 뒤의 username/board-name 부분입니다(예: pinterest/official-news). boards 결과의 각 보드에는 url이 있으며, 여기서 도메인을 제외하면 이 값이 됩니다.Pinterest: 섹션과 구분해 보드 단위로 핀 정리하기 — 공식 문서에 따르면 핀은 보드 안의 섹션에 넣을 수 있습니다. 여기의 `board_id`는 여전히 보드만 대상으로 합니다. 공식 튜토리얼은 이 엔드포인트용 ID 변환 기능을 제공하지 않으며, 섹션 조회 파라미터를 쓸 수 있다는 뜻도 아닙니다. · 확인일
Pinterest board_detail 파라미터는 각각 무엇을 의미하나요?
보드 url로 Pinterest 보드를 확인합니다. 소유자, 설명, 커버, 공개 범위, 공동 작업 여부 플래그, 핀·섹션·팔로워 수를 받을 수 있습니다. 핀 자체는 포함되지 않으며 board_pins로 가져옵니다.
url필수- Pinterest 요청의 대상 URL을 지정합니다. pin 액션에는 /pin/NUMERIC_ID/가 포함된 핀 URL이 필요하고, board_detail에는 /username/boardname/ 형식(또는 상대 경로)의 보드 링크가 필요합니다. 핀 URL 대신 보드 URL을 사용할 수 없습니다.Pinterest: 비밀 보드의 공개 범위 규칙 — 공식 문서에 따르면 비밀 보드는 소유자와 초대된 공동 작업자만 볼 수 있습니다. 보드 링크나 ID를 안다고 해서 접근 권한이 생기는 것은 아니며, 이 페이지는 비밀 설정을 우회하는 기능을 제공하지 않습니다. · 확인일
Pinterest API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"pinterest","action":"search","params":{"keyword":"<keyword>"}}'
Pinterest API 자주 묻는 질문
Pinterest API로 무엇을 가져올 수 있나요?
platform을 pinterest 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 프로필, 사용자 게시물, 핀 상세 정보, 보드 및 more입니다. 각 액션 이름은 서로 다른 Pinterest 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Pinterest search 요청에는 어떤 입력이 필요한가요?
search 액션의 검색어 또는 영감 주제를 지정합니다. 반환되는 결과 엔티티 구조는 선택한 content_type에 따라 달라집니다. params 안의 keyword 필드로 전달하세요.
Pinterest search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 title, text, image_url 및 reaction_count입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Pinterest 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.