> For the complete documentation index, see [llms.txt](https://help.genser.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genser.ai/developers/product-collection.md).

# 상품 데이터 수집 API

{% hint style="info" %}
이 가이드는 **젤라또와 젠서 디스커버리 모두에 적용**됩니다.
{% endhint %}

## **상품 데이터 수집 개요**

상품 데이터 수집 API는 파트너사 시스템의 상품 데이터를 실시간으로 수집하는 연동 방식입니다. 상품 등록·수정·삭제 이벤트를 전달하며, 이미 운영 중인 커머스 환경에 따라 적합한 방식을 선택할 수 있습니다.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-type="content-ref"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>상품 데이터 수집 API</strong></td><td>자체 규격 API</td><td><a href="/files/1K83zbwJdpu6soaMkHMK">/files/1K83zbwJdpu6soaMkHMK</a></td><td><a href="/pages/iobGOJ6VuLAlRyHyszLl#gelatto-api">/pages/iobGOJ6VuLAlRyHyszLl#gelatto-api</a></td><td><a href="/pages/iobGOJ6VuLAlRyHyszLl#gelatto-api">/pages/iobGOJ6VuLAlRyHyszLl#gelatto-api</a></td></tr><tr><td><strong>Google Merchant API</strong></td><td>GMC 표준 규격 그대로 사용</td><td><a href="/files/tdTmLMdjowfUdfUopYSr">/files/tdTmLMdjowfUdfUopYSr</a></td><td><a href="/pages/iobGOJ6VuLAlRyHyszLl#google-merchant-api">/pages/iobGOJ6VuLAlRyHyszLl#google-merchant-api</a></td><td><a href="/pages/iobGOJ6VuLAlRyHyszLl#google-merchant-api">/pages/iobGOJ6VuLAlRyHyszLl#google-merchant-api</a></td></tr></tbody></table>

***

### **상품 데이터 수집 API**

상품 데이터 수집 API는 상품 데이터를 젤라또 플랫폼으로 전송하기 위한 인터페이스입니다. \
상품 등록, 수정, 삭제 이벤트를 실시간으로 수집합니다.

* **문서:** [상품 데이터 수집 API](/developers/product-collection/api.md)
* **서버 ・ 엔드포인트:** `https://api.gelatto.ai`

<table><thead><tr><th width="153.34765625">메서드</th><th width="390.17578125">경로</th><th>설명</th></tr></thead><tbody><tr><td><code>POST</code></td><td><code>/collector/products</code></td><td>상품 등록</td></tr><tr><td><code>PUT</code></td><td><code>/collector/products</code></td><td>상품 수정</td></tr><tr><td><code>PUT</code></td><td><code>/collector/products-delete</code></td><td>상품 삭제</td></tr></tbody></table>

* **인증:** 모든 요청에는 아래 헤더가 필수로 포함되어야 합니다.

<table><thead><tr><th width="154.46484375">헤더명</th><th width="372.19921875">설명</th><th>필수</th></tr></thead><tbody><tr><td><code>Content-Type</code></td><td><code>application/json</code> 고정</td><td>O</td></tr><tr><td><code>Api-Key</code></td><td>발급받은 API 키</td><td>O</td></tr></tbody></table>

{% hint style="info" %}
API 키는 어드민에서 발급 후 사용할 수 있습니다.
{% endhint %}

***

### **Google Merchant API**

GMC Merchant API 규격의 요청 body를 그대로 전용 엔드포인트로 전송하면 됩니다. 별도의 데이터 변환 없이 GMC API 표준 방식 그대로 사용할 수 있습니다.

* **문서:** [Google Merchant API](/developers/product-collection/google-merchant-api.md)

{% hint style="info" %}
GMC Merchant API 규격은 [Google 공식 문서](https://developers.google.com/merchant/api/reference/rest/products_v1/accounts.productInputs?_gl=1*uzno6q*_up*MQ..*_ga*MTE4OTkwOTY4NC4xNzcyNzEyNzM0*_ga_SM8HXJ53K2*czE3NzI3MTI3MzQkbzEkZzAkdDE3NzI3MTI3NTckajM3JGwwJGgw#ProductInput)를 참고해 주세요.&#x20;
{% endhint %}

***

**ⓘ Naver Commerce API**

더 나은 서비스 경험을 제공하기 위해 네이버 커머스 API를 이용한 데이터 연동을 준비 중입니다. \
기능 준비 완료 후 본 가이드 문서도 상세히 업데이트될 예정입니다.&#x20;
