본문으로 바로가기 하단전체메뉴로 바로가기

상품검색

Home / API / T store / 상품검색
T store 의 상품 및 카테고리를 검색/조회 하는 기능을 제공합니다.

API를 활용하여 다음과 같은 서비스를 이용하실 수 있으며, 각 API 별 기능은 아래와 같습니다.
각 API 명을 클릭하시면, 각 API 별 가이드를 보실 수 있습니다.

api 가이드 리스트 소개
구분 제공 기능/Scope 설명
상품검색
API
상품 검색
Tstore 내의 상품을 검색합니다.
상품 상세
Tstore 내의 상품 상세 정보를 조회합니다.
카테고리 상품 조회
Tstore 내의 특정 카테고리에 등록된 상품 리스트를 조회합니다.
카테고리 조회
T store 내의 서비스 중인 카테고리를 조회합니다.

상품 검색

Tstore 내의 상품을 검색합니다.
+ 기본정보
api 기본정보
Resource URI http://apis.skplanetx.com/tstore/products?version={version}&page={page}&count={count}&searchKeyword={searchKeyword}&order={order}
Protocol/
HTTP Method
REST / Get Method
Version 1
Pre-Conditions
N/A
OAuth NO
+ Querystring Parameters
Querystring parameters 정보
Name Data Type Mandatory Example Default Description
version Number Y  1  
API의 버전 정보입니다.
page Number N  1  1
조회할 목록의 페이지
count Number N  10  100
페이지당 출력되는 건수
searchKeyword String Y  앵그리버드  
검색 단어
order String Y  R  R
정렬 조건
<정렬 코드>
- 정확도순 : R
- 최신순 : L
- 다운로드순 : D 
+ Response Parameter
Request Parameters 정보
Name Data Type Mandatory Example Description
tstore Node Y
조회 결과입니다.
  totalCount Number Y
총 상품 수
  products Node Y
상품 목록 정보
    product Node Y
상품 정보
      productId String Y
상품아이디
      name String Y
상품명
      charge Number Y
상품가격
- 무료일 경우 0
      thumbnailUrl String Y
썸네일 URL
      description String Y
한 줄 설명
      downloadCount Number Y
다운로드 수
      score Number Y
평점
      categoryCode String Y
1 Depth 카테고리 코드
      categoryName String Y
1 Depth 카테고리 명
      tinyUrl String Y
Tstore Client(mobile) 상품 상세 URL
      webUrl String Y
Tstore portal(web) 상품 상세 URL
+ Response Sample code
Code type : application/json
{
    "tstore":{
        "totalCount":83,
        "products":{
            "product":[
                {
                    "productId":"0000386278",
                    "webUrl":"http://www.tstore.co.kr/userpoc/game/viewProduct.omp?insDpCatNo=DP01001&insProdId=0000371958&prodGrdCd=0000371958&t_top=DP000501",
                    "categoryName":"게임",
                    "charge":0,
                    "downloadCount":4086,
                    "description":"완벽한 퍼즐게임은 이런것이다!",
                    "thumbnailUrl":"http://wap.tstore.co.kr/android4/201305/27/IF1423497243920130404154254/0000371958/img/thumbnail/0000371958_130_130_0_91_20130527121544.PNG",
                    "name":"퍼즐보석팡팡",
                    "categoryCode":"DP000501",
                    "score":4.88,
                    "tinyUrl":"http://tsto.re/0000371958",
                    "productId":"0000371958"
                },
                {
                    "webUrl":"http://www.tstore.co.kr/userpoc/game/viewProduct.omp?insDpCatNo=DP01005&insProdId=0000386278&prodGrdCd=0000386278&t_top=DP000501",
                    "categoryName":"게임",
                    "charge":1000,
                    "downloadCount":6,
                    "description":"새총을 사용하여 공부벌레를 불량배들에게 쏘세요.",
                    "thumbnailUrl":"http://wap.tstore.co.kr/android4/201305/24/IF1423497568720130409082647/0000386278/img/thumbnail/0000386278_130_130_0_91_20130524054209.PNG",
                    "name":"화난 공부벌레 - Angry Nerds",
                    "categoryCode":"DP000501",
                    "score":0,
                    "tinyUrl":"http://tsto.re/0000386278"
                }
            ]
        }
    }
}
Code type : application/xml
<?xml version="1.0" encoding="UTF-8"?>
<tstore>
    <totalCount>83</totalCount>
    <products>
        <product>
            <productId>0000371958</productId>
            <name><![CDATA[퍼즐보석팡팡]]></name>
            <charge>0</charge>
            <thumbnailUrl><![CDATA[http://wap.tstore.co.kr/android4/201305/27/IF1423497243920130404154254/0000371958/img/thumbnail/0000371958_130_130_0_91_20130527121544.PNG]]></thumbnailUrl>
            <description><![CDATA[완벽한 퍼즐게임은 이런것이다!]]></description>
            <downloadCount>4087</downloadCount>
            <score>4.88</score>
            <categoryCode>DP000501</categoryCode>
            <categoryName>게임</categoryName>
            <webUrl><![CDATA[http://www.tstore.co.kr/userpoc/game/viewProduct.omp?insDpCatNo=DP01001&insProdId=0000371958&prodGrdCd=0000371958&t_top=DP000501]]></webUrl>
            <tinyUrl><![CDATA[http://tsto.re/0000371958]]></tinyUrl>
        </product>
        <product>
            <productId>0000386278</productId>
            <name><![CDATA[화난 공부벌레 - Angry Nerds]]></name>
            <charge>1000</charge>
            <thumbnailUrl><![CDATA[http://wap.tstore.co.kr/android4/201305/24/IF1423497568720130409082647/0000386278/img/thumbnail/0000386278_130_130_0_91_20130524054209.PNG]]></thumbnailUrl>
            <description><![CDATA[새총을 사용하여 공부벌레를 불량배들에게 쏘세요.]]></description>
            <downloadCount>6</downloadCount>
            <score>0</score>
            <categoryCode>DP000501</categoryCode>
            <categoryName>게임</categoryName>
            <webUrl><![CDATA[http://www.tstore.co.kr/userpoc/game/viewProduct.omp?insDpCatNo=DP01005&insProdId=0000386278&prodGrdCd=0000386278&t_top=DP000501]]></webUrl>
            <tinyUrl><![CDATA[http://tsto.re/0000386278]]></tinyUrl>
        </product>
    </products>
</tstore>
+ Error code index
Error Code index 정보
Error Code Message HTTP Status Code
2000 정의되지 않은 요청임
200 Success
4000 기타오류
500 Internal Service Error

상품 상세

Tstore 내의 상품 상세 정보를 조회합니다.
+ 기본정보
api 기본정보
Resource URI http://apis.skplanetx.com/tstore/products/{productId}?version={version}
Protocol/
HTTP Method
REST / Get Method
Version 1
Pre-Conditions
N/A
OAuth NO
+ Request PathParam
request pathparam 정보
Name Data Type Mandatory Example Default Description
productId String Y  000023423  
상품 아이디
+ Querystring Parameters
Querystring parameters 정보
Name Data Type Mandatory Example Default Description
version String Y  1  
API의 버전 정보입니다.
+ Response Parameter
Request Parameters 정보
Name Data Type Mandatory Example Description
tstore Node Y
조회 결과입니다.
  product Node Y
상품 정보
    productId String Y
상품 아이디
    name String Y
상품명
    charge Number Y
상품가격
- 무료일 경우 0
    thumbnailUrl String Y
썸네일 URL
    description String Y
한줄 설명
    detailDescription String Y
상세 설명
    platform String Y
플랫폼
- Andorid , WM , WIPI, Widget, Flash
    categoryPath String Y
카테고리 Path
    osVersion String Y 2.1
OS 버전
    downloadCount Number Y
다운로드 수
    score Number Y
평점
    develperName String Y
개발자 노출명
    developerId String Y
개발자 ID
    categoryCode String Y
1 Depth 카테고리 코드
    categoryName String Y
1 Depth 카테고리 명
    tinyUrl String Y
Tstore Client(mobile) 상품 상세 URL
    webUrl String Y
Tstore portal(web) 상품 상세 URL
    previewUrl String Y
상품 미리보기 이미지 URL, 구분자는 세미콜론( ; )
    models Node Y
모델 목록 정보
      model Node Y
모델 정보
        modelCode String Y
모델코드
        modelName String Y
모델명
+ Response Sample code
Code type : application/json
{
  "tstore": {
    "product": {
      "productId": "0000000234",
      "name": "옵티머스Z",
      "charge": "0",
      "thumbnailUrl": "http://www.tstore.co.kr/images/IF1023038273420100111202617/0000044550/thumbnail/0000044550_72_72_0_25.PNG",
      "description": "한줄 설명입니다.",
      "detailDescription": "상세 설명입니다.",
      "platform": "Android",
      "categoryPath": "생활/위치>뉴스/정보",
      "osVersion": "2.1",
      "downloadCount": "2",
      "score": "4.5",
      "develperName": "lotto",
      "developerId": "lotto",
      "categoryCode": "DP04",
      "categoryName": "생활/위치",
       "tinyUrl": "http://tsto.re/0000000456",
      "webUrl":"http://www.tstore.co.kr/userpoc/game/viewProduct.omp?insDpCatNo=DP01004&insProdId=0000356999&prodGrdCd=PD004402&t_top=DP000501",
      "previewUrl":"http://www.tstore.co.kr/android4/201305/23/IF1424000103420121010145246/0000356999/img/preview/0000356999_DP000103_20130523185533.jpg;http://www.tstore.co.kr/android4/201305/23/IF1424000103420121010145246/0000356999/img/preview/0000356999_DP000104_20130523185533.jpg;http://www.tstore.co.kr/android4/201305/23/IF1424000103420121010145246/0000356999/img/preview/0000356999_DP000105_20130523185534.jpg;http://www.tstore.co.kr/android4/201305/23/IF1424000103420121010145246/0000356999/img/preview/0000356999_DP000106_20130523185535.jpg",
      "models": {
        "model": [
          {
            "modelCode": "LG-SU950",
            "modelName": "옵티머스Z "
          },
          {
            "modelCode": "LG-SU950",
            "modelName": "옵티머스Z "
          }
        ]
      }
    }
  }
}
Code type : application/xml
<?xml version="1.0" encoding="UTF-8"?>
<tstore>
    <product>
        <productId>0000000234</productId>
        <name>옵티머스Z</name>
        <charge>0</charge>
        <thumbnailUrl><![CDATA[http://www.tstore.co.kr/images/IF1023038273420100111202617/0000044550/thumbnail/0000044550_72_72_0_25.PNG]]></thumbnailUrl>
        <description>한줄 설명입니다.</description>
        <detailDescription>상세 설명입니다.</detailDescription>
        <platform>Android</platform>
        <categoryPath><![CDATA[생활/위치>뉴스/정보]]></categoryPath>
        <osVersion>2.1</osVersion>
        <downloadCount>2</downloadCount>
        <score>4.5</score>
        <develperName>lotto</develperName>
        <developerId>lotto</developerId>
        <categoryCode>DP04</categoryCode>
        <categoryName>생활/위치</categoryName>
        <tinyUrl><![CDATA[  http://tsto.re/0000000234 ]]></ tinyUrl>
        <webUrl><![CDATA[http://www.tstore.co.kr/userpoc/game/viewProduct.omp?insDpCatNo=DP01004&insProdId=0000356999&prodGrdCd=PD004402&t_top=DP000501]]></webUrl>
        <previewUrl><![CDATA[http://www.tstore.co.kr/android4/201305/23/IF1424000103420121010145246/0000356999/img/preview/0000356999_DP000103_20130523185533.jpg;http://www.tstore.co.kr/android4/201305/23/IF1424000103420121010145246/0000356999/img/preview/0000356999_DP000104_20130523185533.jpg;http://www.tstore.co.kr/android4/201305/23/IF1424000103420121010145246/0000356999/img/preview/0000356999_DP000105_20130523185534.jpg;http://www.tstore.co.kr/android4/201305/23/IF1424000103420121010145246/0000356999/img/preview/0000356999_DP000106_20130523185535.jpg]]></previewUrl>
        <models>
            <model>
                <modelCode>LG-SU950</modelCode>
                <modelName>옵티머스Z </modelName>
            </model>
            <model>
                <modelCode>LG-SU950</modelCode>
                <modelName>옵티머스Z </modelName>
            </model>
        </models>
    </product>
</tstore>
+ Error code index
Error Code index 정보
Error Code Message HTTP Status Code
2000 정의되지 않은 요청임
200 Success
4000 기타오류
500 Internal Service Error

카테고리 상품 조회

Tstore 내의 특정 카테고리에 등록된 상품 리스트를 조회합니다.
+ 기본정보
api 기본정보
Resource URI http://apis.skplanetx.com/tstore/categories/{categoryCode}?version={version}&page={page}&count={count}&order={order}
Protocol/
HTTP Method
REST / Get Method
Version 1
Pre-Conditions
N/A
OAuth NO
+ Request PathParam
request pathparam 정보
Name Data Type Mandatory Example Default Description
categoryCode String Y  DP000501  
카테고리 코드
+ Querystring Parameters
Querystring parameters 정보
Name Data Type Mandatory Example Default Description
version String Y  1  
API의 버전 정보입니다.
page String N  1  1
조회할 목록의 페이지
count String N  100  100
페이지당 출력되는 건수
order String Y    
정렬 조건
- 유료best순 : C
- 무료 best 순 : F
- 최신순 : N
- 추천순 : R
+ Response Parameter
Request Parameters 정보
Name Data Type Mandatory Example Description
tstore Node Y
조회 결과입니다.
  category Node Y
카테고리 정보
    categoryCode String Y
카테고리 코드
    categoryName String Y
카테고리 명
    totalCount Number Y
카테고리 총 상품수
  products Node Y
상품 목록 정보
    product Node Y
상품 정보
      productId String Y
상품 아이디
      name String Y
상품 명
      charge Number Y
상품가격
- 무료일 경우 0
      thumbnailUrl String Y
썸네일 URL
      description String Y
한줄 설명
      detailDescription String Y
상세 설명
      categoryPath String Y
카테고리 Path
      downloadCount Number Y
다운로드 수
      score Number Y
평점
      tinyUrl String Y
Tstore Client(mobile) 상품 상세 URL
      webUrl String Y
Tstore portal(web) 상품 상세 URL
+ Response Sample code
Code type : application/json
{
  "tstore": {
    "category": {
      "categoryCode": "DP000501",
      "totalCount": "305",
      "categoryName": "게임"
    },
    "products": {
      "product": [
        {
          "productId": "0000000345",
          "name": "앵그리버드",
          "charge": "0",
          "thumbnailUrl": "http://www.tstore.co.kr/images/IF1023038273420100111202617/humbnail/0000044550_72_72_0_25.PNG",
          "description": "한줄 설명입니다.",
          "detailDescription": "상세 설명입니다.",
          "categoryPath": "생활/위치>뉴스/정보",
          "downloadCount": "2",
          "score": "4.5"
        },
        {
          "productId": "0000000345",
          "name": "앵그리버드",
          "charge": "0",
          "thumbnailUrl": " http://www.tstore.co.kr/images/IF1023038273420100111202617/humbnail/0000044550_72_72_0_25.PNG",
          "description": "한줄 설명입니다.",
          "detailDescription": "상세 설명입니다.",
          "categoryPath": "생활/위치>뉴스/정보",
          "downloadCount": "2",
          "score": "4.5",
          "tinyUrl": " http://tsto.re/0000000345/ ",
          "webUrl": "  http://www.tstore.co.kr/userpoc/game/viewProduct.omp?insDpCatNo=DP01003&insProdId=0000000345&prodGrdCd=PD004401&t_top=DP000504"
        }
      ]
    }
  }
}
Code type : application/xml
<?xml version="1.0" encoding="UTF-8" ?>
	<tstore>
		<category>
			<categoryCode>DP000501</categoryCode>
                        <totalCount>305</totalCount>
			<categoryName>게임</categoryName>
		</category>
		<products>
			<product>
				<productId>0000000345</productId>
				<name>앵그리버드</name>
				<charge>0</charge>
				<thumbnailUrl>http://www.tstore.co.kr/images/IF1023038273420100111202617/humbnail/0000044550_72_72_0_25.PNG</thumbnailUrl>
				<description>한줄 설명입니다.</description>
				<detailDescription>상세 설명입니다.</detailDescription>
				<categoryPath>생활/위치&gt;뉴스/정보</categoryPath>
				<downloadCount>2</downloadCount>
				<score>4.5</score>
			</product>
			<product>
				<productId>0000000345</productId>
				<name>앵그리버드</name>
				<charge>0</charge>
				<thumbnailUrl><![CDATA[ http://www.tstore.co.kr/images/IF1023038273420100111202617/humbnail/0000044550_72_72_0_25.PNG]]></thumbnailUrl>
				<description>한줄 설명입니다.</description>
				<detailDescription>상세 설명입니다.</detailDescription>
				<categoryPath>생활/위치&gt;뉴스/정보</categoryPath>
				<downloadCount>2</downloadCount>
				<score>4.5</score>
        <tinyUrl><![CDATA[ http://tsto.re/0000000345/ ]]></tinyUrl>
				<webUrl><![CDATA[  http://www.tstore.co.kr/userpoc/game/viewProduct.omp?insDpCatNo=DP01003&insProdId=0000000345&prodGrdCd=PD004401&t_top=DP000504]]></webUrl>
			</product>
		</products>
	</tstore>
+ Error code index
Error Code index 정보
Error Code Message HTTP Status Code
2000 정의되지 않은 요청임
200 Success
4000 기타오류
500 Internal Service Error

카테고리 조회

T store 내의 서비스 중인 카테고리를 조회합니다.
+ 기본정보
api 기본정보
Resource URI http://apis.skplanetx.com/tstore/categories?version={version}
Protocol/
HTTP Method
REST / Get Method
Version 1
Pre-Conditions
N/A
OAuth NO
+ Querystring Parameters
Querystring parameters 정보
Name Data Type Mandatory Example Default Description
version String Y  1  
API의 버전 정보입니다.
+ Response Parameter
Request Parameters 정보
Name Data Type Mandatory Example Description
tstore Node Y
조회 결과입니다.
  categories Node Y
케테고리 목록 정보
    category Node Y
카테고리 정보
      categoryCode String Y
카테고리 코드
      categoryName String Y
카테고리 명
+ Response Sample code
Code type : application/json
{
    "tstore":{
        "categories":{
            "category":[
                {
                    "categoryName":"게임",
                    "categoryCode":"DP000501"
                },
                {
                    "categoryName":"FUN",
                    "categoryCode":"DP000503"
                },
                {
                    "categoryName":"생활/위치",
                    "categoryCode":"DP000504"
                },
                {
                    "categoryName":"어학/교육",
                    "categoryCode":"DP000508"
                }
            ]
        }
    }
}
Code type : application/xml
<?xml version="1.0" encoding="UTF-8" ?>
<tstore>
  <categories>
    <category>
      <categoryName>게임</categoryName>
      <categoryCode>DP000501</categoryCode>
    </category>
    <category>
      <categoryName>FUN</categoryName>
      <categoryCode>DP000503</categoryCode>
    </category>
    <category>
      <categoryName>생활/위치</categoryName>
      <categoryCode>DP000504</categoryCode>
    </category>
    <category>
      <categoryName>어학/교육</categoryName>
      <categoryCode>DP000508</categoryCode>
    </category>
  </categories>
</tstore>
+ Error code index
Error Code index 정보
Error Code Message HTTP Status Code
2000 정의되지 않은 요청임
200 Success
4000 기타오류
500 Internal Service Error
top버튼