> 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 %}

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

gelatto 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>gelatto 상품 데이터 수집 API</strong></td><td>자체 규격 API</td><td><a href="/files/01g8p8XQZxUKWXYM0KQq">/files/01g8p8XQZxUKWXYM0KQq</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>

***

### **gelatto 상품 데이터 수집 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;


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.genser.ai/developers/product-collection.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.