> 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/api/api-product-list.md).

# 쿠팡 API - Product list

## URL

* <https://sspi-ext-report.adpopcorn.com/v1/metadata/coupang/products>

## Method

* GET

## Request Headers

<table><thead><tr><th width="154">Name</th><th width="85">Type</th><th width="153">Value</th><th width="69" align="center">필수</th><th>설명</th></tr></thead><tbody><tr><td>Authorization</td><td>string</td><td>Bearer ${access_token}</td><td align="center"><mark style="color:red;">Y</mark></td><td>생성된 액세스 토큰을 ${access_token} 자리에 넣어 인증에 사용하세요.</td></tr></tbody></table>

예시 : curl “<https://sspi-ext-report.adpopcorn.com/v1/metadata/coupang/products?page=1”> -H “Authorization: Bearer test\_access\_token” -L

## Parameter

<table><thead><tr><th width="156">Parameter</th><th width="83">Type</th><th width="65">필수</th><th>설명</th></tr></thead><tbody><tr><td>page</td><td>int</td><td>N</td><td>표시된 페이지 수 (default: 1)</td></tr><tr><td>pageSize</td><td>int</td><td>N</td><td>페이지 당 노출될 record 수 (default: 50)</td></tr><tr><td>sortBy</td><td>string</td><td>N</td><td>기본적으로 정렬 순서는 오름차순입니다. 내림차순으로 변경하려면 요청한 필드 앞에 마이너스 기호를 붙이세요. 예시: sortBy=-category_id,product_id</td></tr></tbody></table>

## Content-Type

* application/json

## Response parameter

<table><thead><tr><th width="188">Body parameter</th><th width="142">Type</th><th>설명</th></tr></thead><tbody><tr><td>alert</td><td>string</td><td>서버에서 전송된 알림 메시지. 대부분의 경우 null일 것입니다. 예시: "alert": null</td></tr><tr><td>page</td><td>int</td><td>출력할 페이지 수</td></tr><tr><td>page_size</td><td>int</td><td>페이지 당 노출될 record 수</td></tr><tr><td>page_count</td><td>int</td><td></td></tr><tr><td>total_record_count</td><td>int</td><td></td></tr><tr><td>records</td><td>Array of object</td><td>리포트 데이터</td></tr></tbody></table>

<table><thead><tr><th width="201">ID</th><th width="130">Type</th><th>설명</th></tr></thead><tbody><tr><td>category_id</td><td>numeric</td><td>카테고리 아이디</td></tr><tr><td>category_name</td><td>string</td><td>카테고리 이름</td></tr><tr><td>is_rocket</td><td>Boolean</td><td>로켓배송 여부</td></tr><tr><td>is_free_shipping</td><td>Boolean</td><td>무료 배송 여부</td></tr><tr><td>product_id</td><td>string</td><td>제품 ID</td></tr><tr><td>product_name</td><td>string</td><td>제품 이름</td></tr><tr><td>product_price</td><td>numeric</td><td>제품 가격</td></tr><tr><td>product_url</td><td>string</td><td>제품 URL</td></tr><tr><td>product_image</td><td>string</td><td>제품 이미지</td></tr></tbody></table>

{% tabs %}
{% tab title="200" %}
{% code title="json" %}

```json
{
	"alert": null,
	"page": 1,
	"page_size": 50,
	"page_count": 2,
	"total_record_count": 71,
	"records": [
		{
			"category_id": 1,
			"category_name": "test category",
			"is_rocket": false,
			"is_free_shipping": false,
			"product_id": "test product id 1",
			"product_name": "test product name 1",
			"product_price": 18170,
			"product_url": "<coupang link>",
			"product_image": "<coupang product image url>"
		},
		{
			"category_id": 1,
			"category_name": "test category",
			"is_rocket": false,
			"is_free_shipping": false,
			"product_id": "test product id 2",
			"product_name": "test product name 2",
			"product_price": 31300,
			"product_url": "<coupang link>",
			"product_image": "<coupang product image url>"
	  }
	]
}
```

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

## 서버 응답 코드

아래 표는 Adpopcorn API 플랫폼에서 REST API 응답으로 전송되는 일반적인 HTTP 상태 코드를 나열한 것입니다.

<table><thead><tr><th width="126">Code</th><th width="173">메세지</th><th>설명</th></tr></thead><tbody><tr><td>200</td><td>성공</td><td>요청이 성공적으로 처리되었습니다.</td></tr><tr><td>400</td><td>client-side 에러</td><td>유효성 검사에 실패했습니다.</td></tr><tr><td>401</td><td>인증되지 않음</td><td>인증 또는 권한 부여 실패가 발생했습니다.</td></tr><tr><td>500</td><td>API-side 에러</td><td>Adpopcorn API 플랫폼에 문제가 발생했습니다.</td></tr></tbody></table>