> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Lotte ON API

> Recherchez des produits sur la boutique Lotte ON et lisez ses pages produit en JSON : classement avec prix, notes, nombres d’avis et marques pour la recherche, et prix, disponibilité, vendeur, images et caractéristiques pour chaque page produit.

Recherchez des produits sur la boutique Lotte ON (lotteon.com) et lisez ses pages produit via l’API de tâches asynchrones. Envoyez `COMMERCE_SERP` avec `site` `lotteon` pour recevoir les produits qu’affiche une recherche, dans l’ordre de la boutique, ou `COMMERCE_PRODUCT` avec l’`url` d’un produit pour lire ce produit. Une recherche ou une page produit terminée coûte **0.5 crédit**.

## Recherche

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "COMMERCE_SERP", "payload": { "site": "lotteon", "query": "airpods", "limit": 3 } }'
```

Soumettez la tâche, puis interrogez `GET /v1/async/task/{id}` ou recevez son webhook. Voir [Tâches asynchrones](https://docs.querying.ai/fr/concepts/async-tasks.md).

### Paramètres

* `site` : obligatoire. `lotteon`.
* `query` : obligatoire. Terme de recherche, de 1 à 500 caractères.
* `limit` : entier facultatif de 1 à 40, avec 20 par défaut.
* `country` : facultatif. Par défaut, `KR`, le pays de la boutique. Tout autre pays est refusé avec `422 REGION_UNSUPPORTED`.

Seuls les champs de payload listés ci-dessus sont acceptés. Omettez `include` : même `include: {}` renvoie `422 VALIDATION_ERROR` sur `payload.include` avant toute réservation de crédits.

### Exemple de réponse

```json theme={"theme":"css-variables"}
{
  "site": "lotteon",
  "query": "airpods",
  "country": "KR",
  "returnedCount": 3,
  "products": [
    {
      "rank": 1,
      "productId": "LO2762983012",
      "title": "알루무 A39 에어팟 프로 3 호환 이어폰 보호 케이스 스트랩포함 AirPods",
      "url": "https://www.lotteon.com/p/product/LO2762983012?sitmNo=LO2762983012_2762983014&mall_no=1",
      "price": 57800,
      "currency": "KRW",
      "brand": "알루무",
      "imageUrl": "https://contents.lotteon.com/itemimage/20261011194224/LO/27/62/98/30/12/_2/76/29/83/01/4/LO2762983012_2762983014_1.png/dims/optimize/resizemc/400x400"
    },
    {
      "rank": 2,
      "productId": "LO2545544028",
      "title": "Apple Airpods Pro 3 애플 에어팟 프로 3 노이즈캔슬링 블루투스 이어폰/ 관부가세포함",
      "url": "https://www.lotteon.com/p/product/LO2545544028?sitmNo=LO2545544028_2545544029&mall_no=1",
      "price": 335330,
      "currency": "KRW",
      "rating": 5,
      "reviewCount": 2,
      "brand": "Apple",
      "imageUrl": "https://contents.lotteon.com/itemimage/20260828122445/LO/25/45/54/40/28/_2/54/55/44/02/9/LO2545544028_2545544029_1.jpg/dims/optimize/resizemc/400x400"
    },
    {
      "rank": 3,
      "productId": "LO2797494125",
      "title": "SUPCASE 에어팟 프로3 케이스 AirPods Pro3 방수케이스 맥세이프 섭케이스",
      "url": "https://www.lotteon.com/p/product/LO2797494125?sitmNo=LO2797494125_2797494126&mall_no=1",
      "price": 69870,
      "currency": "KRW",
      "imageUrl": "https://contents.lotteon.com/itemimage/20261020093459/LO/27/97/49/41/25/_2/79/74/94/12/6/LO2797494125_2797494126_1.jpg/dims/optimize/resizemc/400x400"
    }
  ]
}
```

### Champs du résultat

* `site`, `query` et `country` reprennent la requête. `returnedCount` est le nombre d’éléments de `products`.
* Chaque produit comporte `rank`, `productId`, `title` et `url`. `productId` est l’identifiant produit propre à la boutique. `rank` suit l’ordre par défaut de la boutique, et les annonces que la boutique marque comme sponsorisées sont exclues.
* `price`, `rating`, `reviewCount`, `imageUrl` et `brand` apparaissent quand la page de résultats les affiche. `price` est un nombre dans la `currency` du produit (ISO 4217) ; quand les formats ont des prix différents, c’est le plus bas.
* `rating` utilise une échelle de cinq points. Les nombres d’avis abrégés, comme 999+, sont omis.
* Chaque recherche renvoie les produits de la première page de résultats de la boutique.

## Page produit

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "COMMERCE_PRODUCT", "payload": { "url": "https://www.lotteon.com/p/product/LO2762983012?sitmNo=LO2762983012_2762983014&mall_no=1" } }'
```

### Paramètres

* `url` : obligatoire. Une page produit de la boutique Lotte ON, de 2 048 caractères au plus : `lotteon.com/p/product/{id}`. Les `url` de produit renvoyées par une recherche s’utilisent telles quelles. Les paramètres sans effet sur le résultat, comme les codes de suivi, sont retirés avant la lecture.
* `country` : facultatif. Par défaut, `KR`, le pays de la page. Tout autre pays est refusé avec `422 REGION_UNSUPPORTED`.

Seuls les champs de payload listés ci-dessus sont acceptés. Omettez `include` : même `include: {}` renvoie `422 VALIDATION_ERROR` sur `payload.include` avant toute réservation de crédits.

### Exemple de réponse

```json theme={"theme":"css-variables"}
{
  "site": "lotteon",
  "country": "KR",
  "url": "https://www.lotteon.com/p/product/LO2762983012?sitmNo=LO2762983012_2762983014&mall_no=1",
  "productId": "LO2762983012",
  "title": "알루무 A39 에어팟 프로 3 호환 이어폰 보호 케이스 스트랩포함 AirPods",
  "brand": "알루무",
  "price": 54910,
  "currency": "KRW",
  "inStock": true,
  "seller": "롯데ON",
  "images": [
    "https://contents.lotteon.com/itemimage/20261011194224/LO/27/62/98/30/12/_2/76/29/83/01/4/LO2762983012_2762983014_1.png"
  ],
  "descriptionImages": [
    "https://ai.esmplus.com/moadeli/notice/notice_top.jpg",
    "https://shop-phinf.pstatic.net/20260904_172/1788461038021RFJty_PNG/2%EC%97%B4_%EC%98%B5%EC%85%98-_%EB%B3%B5%EC%82%AC%EB%B3%B8_(1).png"
  ],
  "specs": [
    { "name": "품명 및 모델명", "value": "상품 상세설명 참조" },
    { "name": "법에 의한 인증, 허가 등을 받았음을 확인할 수 있는 경우 그에 대한 사항", "value": "상품 상세설명 참조" },
    { "name": "제조국 또는 원산지", "value": "상품 상세설명 참조" }
  ],
  "categories": ["해외직구", "TV/영상/음향기기", "헤드폰/이어폰"]
}
```

### Champs du résultat

* `site`, `country`, `url` et `productId` identifient la page. `url` est la page lue, et `productId` correspond à celui que renvoie une recherche.
* `title` est toujours présent. `brand`, `price`, `currency`, `inStock`, `seller`, `images`, `description`, `descriptionImages`, `specs` et `categories` apparaissent quand la page les affiche.
* `price` est ce que paie un acheteur tel que la page l’affiche à l’ouverture, avant coupons et livraison, en `currency` (ISO 4217). `inStock` indique la disponibilité du produit. `seller` est le marchand qui le vend.
* `images` liste jusqu’à 30 photos de la galerie du produit, dans l’ordre de la page. Cette boutique ne renvoie que la photo principale.
* `description` est du texte brut avec une ligne par paragraphe, jusqu’à 10 000 caractères ; le texte qui n’apparaît que dans des images n’est pas inclus. Cette boutique affiche la plupart des détails produit sous forme d’images, donc peu de ses pages ont une `description`.
* `descriptionImages` liste jusqu’à 300 images de la description du produit, dans l’ordre de la page. Les bannières et avis que les vendeurs placent dans leur description sont inclus, et le texte des images n’est pas lu.
* `specs` liste jusqu’à 100 paires `{ name, value }` des caractéristiques du produit. `categories` va de la catégorie la plus large à la plus précise, sur 10 niveaux au plus.

## Erreurs et facturation

* Une recherche qui ne renvoie aucun produit se termine par une tâche en échec.
* Une page produit à laquelle la boutique répond 404 ou 410, comme un produit retiré, termine la tâche avec `PAGE_UNAVAILABLE`, et le message reprend la réponse de la boutique. Si la boutique refuse la lecture avec 403, 412, 429 ou 435, la tâche attend et redemande pendant 6 minutes au plus. Les autres lectures échouées, et un refus qui dure plus longtemps, se terminent par `ENGINE_NO_RESULT`.
* Seules les tâches terminées sont facturées : 0.5 crédit par recherche ou page produit.

## Voir aussi

* [Coupang](https://docs.querying.ai/fr/engines/coupang.md)
* [Olive Young](https://docs.querying.ai/fr/engines/oliveyoung.md)
* [11st](https://docs.querying.ai/fr/engines/11st.md)
* [Toutes les boutiques Commerce](https://docs.querying.ai/fr/engines/overview.md#commerce)
* [Crédits et limites](https://docs.querying.ai/fr/concepts/credits-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.