플랫폼 가용성
- 24시간 상태
- 98%
최근 30일
제공 기능
각 Shopee 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | 키워드로 Shopee 마켓플레이스의 상품을 검색하며, 가격, 정가와 할인, 평점, 판매량, 판매자 위치, Shopee Mall 여부 플래그를 제공합니다. | 요청 1,000개당 $6.4 | 양호 · 상태 100% |
상품 상세 정보profile | 전체 url로 Shopee 상품 페이지를 엽니다. | 요청 1,000개당 $1.39 | 양호 · 상태 98% |
숍shop | 사용자 이름이나 숫자 ID로 Shopee 상점의 판매 상품을 탐색하며, 각 상품 정보의 가격, 할인, 평점, 판매량, Mall 여부를 제공합니다. | 요청 1,000개당 $1.39 | 정상 |
상품 상세 정보product_detail | 상품 링크로 Shopee 상품 정보 전체를 읽어 옵니다. | 요청 1,000개당 $1.39 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Shopee 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 키워드로 Shopee 마켓플레이스의 상품을 검색하며, 가격, 정가와 할인, 평점, 판매량, 판매자 위치, Shopee Mall 여부 플래그를 제공합니다. | keyword | country, max_price, min_price, sort | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $6.4 | shop_id · item_id · name · url · image_url · price · original_price · discount_pct · currency · rating · rating_scale · rating_count · sold_count · location · is_mall · platform |
profile상품 상세 정보 전체 | url | country | Sync 응답 | — | 요청 1,000개당 $1.39 | shop_id · item_id · name · url · description · price · price_min · price_max · original_price · discount_pct · currency · rating · rating_scale · rating_count · sold_count · stock · liked_count · view_count · brand · is_pre_order · has_video · platform · images · shop |
shop숍 사용자 이름이나 숫자 ID로 Shopee 상점의 판매 상품을 탐색하며, 각 상품 정보의 가격, 할인, 평점, 판매량, Mall 여부를 제공합니다. 상점 리뷰, 재무 정보, 비공개 주문은 포함되지 않으며, 전체 카탈로그는 보장되지 않습니다. | shop | country | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | shop_id · item_id · name · url · image_url · price · original_price · discount_pct · currency · rating · rating_scale · rating_count · sold_count · location · is_mall · platform |
product_detail상품 상세 정보 상품 링크로 Shopee 상품 정보 전체를 읽어 옵니다. 설명, 옵션, 할인 문구, 재고, 판매량, 리뷰, 상점 이름과 위치를 받을 수 있습니다. 시장마다 통화가 다르므로 | url | country | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · name · text · price · original_price · currency · discount · stock · sold_count · rating · rating_scale · review_count · shop_name · shop_location · variants · image_url · platform |
Shopee search 파라미터는 각각 무엇을 의미하나요?
키워드로 Shopee 마켓플레이스의 상품을 검색하며, 가격, 정가와 할인, 평점, 판매량, 판매자 위치, Shopee Mall 여부 플래그를 제공합니다. country의 기본값은 인도네시아이며, 가격 필터는 해당 시장의 통화를 사용합니다.
keyword필수search의 상품 검색 키워드를 지정합니다. 대상 지역 마켓플레이스는country로 결정됩니다.country선택- 지역 코드를 설정하며,
region및 URL 기반 추론보다 우선합니다.search,profile,shop에서 지정하지 않으면id(인도네시아)가 기본값입니다. 도메인 감지 대상은sg,my,th,ph,vn,br,tw,mx,co,cl이지만, 도메인이 인식되더라도 모든 지역의 데이터를 보장하지는 않습니다.product_detail은 보통 상품 URL에서 지역을 읽습니다.허용 값:brclcoidmxmyphsgthtwvn max_price선택- 대상 마켓플레이스의 가격 단위로 최대 상품 가격을 설정합니다. min_price와 함께 사용해 범위를 지정하세요. 필터링은 정수 기준이며 소수점은 올림 처리됩니다(145.98은 146).
min_price선택- 대상 시장의 통화 단위를 기준으로
search의 최소 상품 가격을 설정합니다. 지역마다 같은 통화라고 가정하지 마세요. API 과금 금액을 나타내는 파라미터가 아닙니다. 필터링은 정수 기준이며 소수점은 내림 처리됩니다(39.81은 39). sort선택search의 상품 검색 결과를 정렬합니다. 허용 값은relevance,popular(판매량 기준),newest,price_asc,price_desc입니다.shop의 상품 목록이나 상품 상세에는 사용되지 않습니다.허용 값:newestpopularprice_ascprice_descrelevance
Shopee profile 파라미터는 각각 무엇을 의미하나요?
전체 url로 Shopee 상품 페이지를 엽니다. 설명, 옵션별 가격 범위, 재고, 판매량, 좋아요 수, 브랜드, 예약 판매 여부를 받을 수 있습니다. 이름과 달리 구매자나 판매자가 아닌 상품을 설명합니다. 단축 링크는 먼저 최종 페이지 주소로 변환하세요.
url필수profile과product_detail에 사용할 Shopee 상품 전체 URL을 지정합니다.profile은i.shop_id.product_id패턴으로 식별자를 추출합니다. 단축 링크는 먼저 최종 랜딩 페이지 URL로 변환해야 하며, 그대로 전달하면 파싱을 보장하지 않습니다.Shopee: 숍 ID와 상품 ID 찾기 — Shopee 판매자 교육 자료는 Shop ID, Item ID, 사용자 이름, 숍 표시 이름을 구분하며, 이 식별자들을 서로 바꿔 쓰지 말라고 안내합니다. 이 참고 자료는 해당 용어를 인용할 뿐이며, 다른 지역에서도 판매자 센터 운영 절차가 같다고 보장하지 않습니다. · 확인일country선택- 지역 코드를 설정하며,
region및 URL 기반 추론보다 우선합니다.search,profile,shop에서 지정하지 않으면id(인도네시아)가 기본값입니다. 도메인 감지 대상은sg,my,th,ph,vn,br,tw,mx,co,cl이지만, 도메인이 인식되더라도 모든 지역의 데이터를 보장하지는 않습니다.product_detail은 보통 상품 URL에서 지역을 읽습니다.허용 값:brclcoidmxmyphsgthtwvn
Shopee shop 파라미터는 각각 무엇을 의미하나요?
사용자 이름이나 숫자 ID로 Shopee 상점의 판매 상품을 탐색하며, 각 상품 정보의 가격, 할인, 평점, 판매량, Mall 여부를 제공합니다. 상점 리뷰, 재무 정보, 비공개 주문은 포함되지 않으며, 전체 카탈로그는 보장되지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태shop필수shop에 사용할 상점 사용자 이름 또는 숫자 상점 ID를 지정합니다(@접두사는 선택). 상점 리뷰가 아니라 상점의 상품 목록을 반환합니다.Shopee: 사용자 이름과 숍 표시 이름의 차이 — Shopee는 로그인용 사용자 이름과 구매자에게 보이는 Shop Name을 따로 안내합니다. 숍 표시 이름에는 공백이 들어갈 수 있으며, 이 파라미터에 필요한 사용자 이름이나 Shop ID를 대신할 수 없습니다. · 확인일country선택- 지역 코드를 설정하며,
region및 URL 기반 추론보다 우선합니다.search,profile,shop에서 지정하지 않으면id(인도네시아)가 기본값입니다. 도메인 감지 대상은sg,my,th,ph,vn,br,tw,mx,co,cl이지만, 도메인이 인식되더라도 모든 지역의 데이터를 보장하지는 않습니다.product_detail은 보통 상품 URL에서 지역을 읽습니다.허용 값:brclcoidmxmyphsgthtwvn
Shopee product_detail 파라미터는 각각 무엇을 의미하나요?
상품 링크로 Shopee 상품 정보 전체를 읽어 옵니다. 설명, 옵션, 할인 문구, 재고, 판매량, 리뷰, 상점 이름과 위치를 받을 수 있습니다. 시장마다 통화가 다르므로 price는 currency와 함께 확인하세요. 표시된 재고가 실제 구매 가능 수량을 보장하지는 않습니다.
url필수profile과product_detail에 사용할 Shopee 상품 전체 URL을 지정합니다.profile은i.shop_id.product_id패턴으로 식별자를 추출합니다. 단축 링크는 먼저 최종 랜딩 페이지 URL로 변환해야 하며, 그대로 전달하면 파싱을 보장하지 않습니다.country선택- 지역 코드를 설정하며,
region및 URL 기반 추론보다 우선합니다.search,profile,shop에서 지정하지 않으면id(인도네시아)가 기본값입니다. 도메인 감지 대상은sg,my,th,ph,vn,br,tw,mx,co,cl이지만, 도메인이 인식되더라도 모든 지역의 데이터를 보장하지는 않습니다.product_detail은 보통 상품 URL에서 지역을 읽습니다.허용 값:bridmxmyphsgthvn
Shopee 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":"shopee","action":"search","params":{"keyword":"<keyword>"}}'
Shopee API 자주 묻는 질문
Shopee API로 무엇을 가져올 수 있나요?
platform을 shopee 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 상품 상세 정보, 숍 및 상품 상세 정보입니다. 각 액션 이름은 서로 다른 Shopee 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Shopee search 요청에는 어떤 입력이 필요한가요?
search의 상품 검색 키워드를 지정합니다. 대상 지역 마켓플레이스는 country로 결정됩니다. params 안의 keyword 필드로 전달하세요.
Shopee search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 shop_id, item_id, name 및 image_url입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Shopee 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.