> For the complete documentation index, see [llms.txt](https://adpopcornssp.gitbook.io/ssp-sdk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://adpopcornssp.gitbook.io/ssp-sdk/undefined-2/extra-guide/coupang/search.md).

# 검색 API 연동

## URL

```url
https://ssp-ext-proxy.adpopcorn.com/coupang/search
```

## Method

```
GET
```

## Headers

```http
Content-Type: application/json
```

## Request parameter

<table><thead><tr><th width="123.55560302734375">Query parameter</th><th width="97.5555419921875">Type</th><th width="107.77783203125" data-type="checkbox">Required</th><th width="416.4442138671875">설명</th></tr></thead><tbody><tr><td>keyword</td><td>String</td><td>true</td><td>검색 키워드 (<mark style="color:$danger;"><strong>URL Encoded</strong></mark>)</td></tr><tr><td>subIds</td><td>String</td><td>true</td><td>채널 아이디 리스트 (최대 5개까지 사용 콤마로 구분하여 사용 가능)</td></tr><tr><td>limit</td><td>Integer</td><td>false</td><td>최대 상품 수 (기본값: 10, 최대값: 10)</td></tr></tbody></table>

#### 요청 예제

{% code overflow="wrap" %}

```bash
https://ssp-ext-proxy.adpopcorn.com/coupang/search?keyword=%EA%B1%B4%EA%B0%95&subIds=TESTSUBID&limit=5 ## keyword=건강
```

{% endcode %}

## Response

<table><thead><tr><th width="188">Body parameter</th><th width="142">Type</th><th>설명</th></tr></thead><tbody><tr><td>rCode</td><td>String</td><td><p>상태코드<br><br>0: 정상</p><p>204: 추천 상품 없음</p><p>400: 파라미터 오류</p><p>403: 인증 오류</p><p>404: 채널 ID 없음</p><p>429: 요청량 초과</p><p>500: 서버 오류</p></td></tr><tr><td>rMessage</td><td>String</td><td>상태메시지</td></tr><tr><td>data</td><td>object</td><td></td></tr><tr><td>   keyword</td><td>String</td><td>검색 키워드</td></tr><tr><td>   landingUrl</td><td>String</td><td>검색 페이지 URL</td></tr><tr><td>   productData</td><td><a href="#product">Product</a>[]</td><td>상품 리스트</td></tr></tbody></table>

### Product 객체

<table><thead><tr><th width="159">ID</th><th width="174">Type</th><th>설명</th></tr></thead><tbody><tr><td>productId</td><td>Integer</td><td>상품 ID</td></tr><tr><td>productName</td><td>String</td><td>상품명</td></tr><tr><td>productPrice</td><td>Integer</td><td>가격 (KRW)</td></tr><tr><td>productImage</td><td>String</td><td>상품 이미지 URL</td></tr><tr><td>productUrl</td><td>String</td><td>상품 페이지의 트래킹 URL</td></tr><tr><td>categoryName</td><td>String</td><td>상품 카테고리 (최대 길이 20자)</td></tr><tr><td>rank</td><td>Integer</td><td>순위</td></tr><tr><td>isRocket</td><td>Boolean</td><td>로켓 배송 여부</td></tr><tr><td>isFreeShipping</td><td>Boolean</td><td>무료 배송 여부</td></tr></tbody></table>

{% hint style="warning" %}

#### 일부 제휴사 채널 아이디의 경우 상품 카테고리와 순위를 제공하지 않습니다.

{% endhint %}

#### 응답 예제

{% tabs %}
{% tab title="성공" %}
{% code lineNumbers="true" expandable="true" %}

```json
{
    "rCode": "0",
    "rMessage": "게시글 작성 시, \"파트너스 활동을 통해 일정액의 수수료를 제공받을 수 있음\"을 기재하셔야 합니다",
    "data": {
        "keyword": "건강",
        "landingUrl": "https://link.coupang.com/re/AFFSRP?lptag=AF8906060&subid=CPCsggcgaD&pageKey=%EA%B1%B4%EA%B0%95&traceid=V0-163-7748847943a6160f&requestid=20260518172448522306224835",
        "productData": [
            {
                "productId": 8179675031,
                "productName": "종근당건강 홍삼정 스틱 30p, 300g, 1개",
                "productPrice": 22050,
                "productImage": "https://ads-partners.coupang.com/image1/rns236zZUn9MmnGSriS-viyRSx1inWlSMjxyNUXp673XvKlCLIvx430BhLPqB4qngYBhNaaTxSx3TsX_TxpIIZvp0xRuO_HzqsLGdxft0WRsA_SG1uZ3ZJO-8bHAS6ph94gRZwdCvYt5WoLTa374XOcrrLnClKlHAoE3ATuvuz8ZajfxoFNowq6gk6B8aOLvwDIX6nwX_MefbofZH7t0-HtcaMQ-uAglK_4vvZSw0pBHObJAD7yNY93gRLho0FB0b_7d8Nr3hswX7_LS_WzNgZnGY5se3LheR2PmCGF6rBTAa9iCy7JPq5FlQBi_-jAw",
                "productUrl": "https://link.coupang.com/re/AFFSDP?lptag=AF8906060&subid=CPCsggcgaD&pageKey=8179675031&itemId=23450447299&vendorItemId=90477214094&traceid=V0-153-da20e6b5645bfe28&clickBeacon=08ca6cb0-5293-11f1-a60b-f6abd44edc24%7E3&requestid=20260518172448522306224835&token=31850C%7CMIXED",
                "categoryName": "식품",
                "rank": 1,
                "isRocket": true,
                "isFreeShipping": false
            },
            {
                "productId": 8203535204,
                "productName": "종근당 침향환 골드",
                "productPrice": 60590,
                "productImage": "https://ads-partners.coupang.com/image1/em9wOykQcSLG89uZeoR7uSyFQgU-BDOuq4aKogFJcFtUMxBvE-flM3nmZD7L1hXhGSlUC2TsE_2eo0jFYEP6ta9EQSfoIgVpJyBjO2pC6cAUVIWNqglbg1KxHR_kdBpXHqNqPXW83odm1GEnW_cnfKMpLhd7oE05NcE80vQvTMM6o9Sl1bHft7zq1E_1EG75DSGgR8niuV_-S1D8kQVaRFR9Su9e9N1K3EOJy7cbQWAQJlo2E11oXA3ksDBo2uQwLYv0CJLDEu1wFLtnq95B8-AdP3fXM44DGoVQ29mNJe4LysDxlMGXJ6eE",
                "productUrl": "https://link.coupang.com/re/AFFSDP?lptag=AF8906060&subid=CPCsggcgaD&pageKey=8203535204&itemId=476855525&vendorItemId=4196527902&traceid=V0-153-df64d5f372ea0b38&requestid=20260518172448522306224835&token=31850C%7CMIXED",
                "categoryName": "식품",
                "rank": 2,
                "isRocket": true,
                "isFreeShipping": false
            },
            {
                "productId": 9432960172,
                "productName": "뉴트리정 올인원 멀티비타민 미네랄 데일리 플러스 대용량",
                "productPrice": 16900,
                "productImage": "https://ads-partners.coupang.com/image1/3pappF-dL3_tcUcS3hi-Zunsj36TNUAVYCZwfcejkyMvyOLGkI92R4WDs0nodi1hhPt21Oj_YLpYjKqaYshrnC7nPxtD-yGSma94qPndSOyjb9tNoZaKYKT6XrKySHZyLhZiAzB33J7u9RKJj4VRBpjjOEK5sqV_8BSA_hrxroWxwvMiaSvLQR7wP2YRGC4X6ULv4FlJgTQbfGEeBKjbLvE3Xtnfl08U9XbIvBjW2emCGjIGBoPQ_pHrbuak3SJCYMwA-52erTPFAFOsJDtbWzlehm1YDv8dNnGu1lzTuuoBkpO2ol0EQonVVcJF6irw_F66WF2ugBNhd0Y=",
                "productUrl": "https://link.coupang.com/re/AFFSDP?lptag=AF8906060&subid=CPCsggcgaD&pageKey=9432960172&itemId=28048113581&vendorItemId=95004970171&traceid=V0-153-591a329cdb1507ba&requestid=20260518172448522306224835&token=31850C%7CMIXED",
                "categoryName": "식품",
                "rank": 3,
                "isRocket": true,
                "isFreeShipping": false
            },
            {
                "productId": 66934000,
                "productName": "종근당 황제 침향단 + 쇼핑백",
                "productPrice": 34900,
                "productImage": "https://ads-partners.coupang.com/image1/Unl6gll7IJKNiHM_Uj5KY9ndv65NvcRvXLDd-VX1PTw3UzJQbZOOkBMXmcI9Xn1lGgohnNVexekENQ6TgXc22tKBguRMa1CrVTmBDixhp01hrbCp7ZldQJVMwns4aWKZ2wsBPZCTH48UY7vsGO3sWzwJwKS4S9oJulqxbbAJflBfQ9SiWw_aRJ63zJvZ76jEM25JuCTnyY--c0gXpfo-efklDQhcuqSyYtE5acuuPEtw5yIhmezdvd10BRFzTSV1Gz-tTysK1LTHANFdpmJZJKNjAdebuN-nCU33F6uT6WHWPmEhxhV1ryrQ",
                "productUrl": "https://link.coupang.com/re/AFFSDP?lptag=AF8906060&subid=CPCsggcgaD&pageKey=66934000&itemId=224760773&vendorItemId=3546165547&traceid=V0-153-92819b1ad0651a97&requestid=20260518172448522306224835&token=31850C%7CMIXED",
                "categoryName": "식품",
                "rank": 4,
                "isRocket": true,
                "isFreeShipping": false
            },
            {
                "productId": 7895335455,
                "productName": "풍년보감 6년근 고려홍삼정 올데이굿타임 스틱 100p",
                "productPrice": 25130,
                "productImage": "https://ads-partners.coupang.com/image1/M7d41lXOcXh5wbS-MzdKeyQ_8o1opxhhKt640aa9SK3C1Tq3uCnLAl9L9qOdsB4vd6EIyd_4FqPtBUp4LtfNyQz41zNlAJrry2i0ZVl1uQyxb4-EXG41vD-_vPW14c0xvL6I_i3l-g2zLVrb-BslczpGYGPqkgI9K8tOr9DXR_ireTS3y4t9uGWAS8q8sADn8bi14m58os5tAtEIaMyLAkoI3NZqSva1QCN1KN_HGOFIfd8Tp8UZ4pa_Q5pjLn-of5WCTY-4X6iIVG9lVYLVTebW0jk7UKHbwQt4yPUVKgpO5cSLGFfsKSeh_w==",
                "productUrl": "https://link.coupang.com/re/AFFSDP?lptag=AF8906060&subid=CPCsggcgaD&pageKey=7895335455&itemId=21625226047&vendorItemId=94200197879&traceid=V0-153-0ea2c798c26b03f5&requestid=20260518172448522306224835&token=31850C%7CMIXED",
                "categoryName": "식품",
                "rank": 5,
                "isRocket": true,
                "isFreeShipping": false
            }
        ]
    }
}
```

{% endcode %}
{% endtab %}

{% tab title="실패 (400)" %}
{% code overflow="wrap" %}

```json
{
    "rCode": "400",
    "rMessage": "파라미터 오류"
}
```

{% endcode %}
{% endtab %}
{% endtabs %}