API

KREAM API: 즉시 구매가와 시세를 JSON으로

KREAM에는 개발자용 공개 API가 없습니다. 여기서 돌려주는 것은 사이트가 공개적으로 보여 주는 내용입니다. 리셀 시장에서 의미 있는 숫자는 한 시점의 가격이 아니라 흐름이라, 이 모터에서 가장 쓸모 있는 엔드포인트는 **시세 그래프**입니다. 1개월, 3개월, 6개월, 1년, 전체 기간을 그대로 받아 볼 수 있습니다.

무료 키 받기 전체 문서: 모든 엔드포인트와 파라미터 →

엔드포인트

endpoint	무엇이 반환되는가	필수
search	키워드 검색. 각 상품에 즉시 구매가(최저 판매 희망가)가 함께 돌아옵니다.	query
product/detail	상품 전체: 영문명과 한글명, 브랜드, 이미지, 즉시 구매가.	product_id
product/price_history	KREAM의 시세 그래프. 1개월, 3개월, 6개월, 1년 또는 전체 기간을 지정합니다.	product_id
category	한 카테고리의 모든 상품, 페이지 단위로, 검색과 같은 정렬과 필터를 지원합니다.	category_id
categories	카테고리 트리: 최상위 카테고리 또는 그 하위 카테고리.	모두 선택

호출마다 크레딧이 차감됩니다. 실패하거나 차단된 호출은 무료입니다.

동작하는 예제

리셀은 한 시점 가격만 보면 판단이 어긋납니다. 발매 직후와 반년 뒤의 가격대가 전혀 다르기 때문에, 시세 그래프를 먼저 보고 현재가를 그 안에 놓아야 의미가 생깁니다.

요청

curl -X POST https://api.reefapi.com/kream/v1/product/price_history \
  -H "x-api-key: 발급받은_키" \
  -H "content-type: application/json" \
  -d '{"product_id": "...", "period": "6m"}'

응답 (요약)

{
  "ok": true,
  "data": {
    "history": [
      { "date": "2026-05-01", "price": 289000 },
      { "date": "2026-06-01", "price": 312000 }
    ]
  },
  "meta": { "record_count": 180, "cache_hit": false, "mode": "live" }
}

직접 크롤러를 만드는 대신

KREAM 크롤러는 첫날에는 동작합니다. 어려워지는 건 그다음입니다. 목록 구조가 바뀌면 파서는 오류 없이 빈 배열을 돌려주고, 봇 차단이 걸리면 요청이 조용히 막힙니다. 두 경우 모두 '상품이 없다'와 똑같아 보입니다.

시세 그래프는 특히 직접 긁기 번거로운 부분입니다. 차트가 비동기로 그려지고 기간마다 요청이 달라서, 한 번 맞춰 놓아도 화면이 바뀌면 먼저 깨지는 곳이 여기입니다.

한 번만 돌릴 작업이라면 직접 만든 스크립트가 더 쌉니다. 솔직히 그렇습니다. 매일 돌아가야 하는 시세 추적이라면 비용은 코드가 아니라 아무도 모르게 멈춘 수집기에 쌓입니다.

This page in English →전체 문서: 모든 엔드포인트와 파라미터 →

한국어로 된 다른 문서

쿠팡 API 문서

제한과 솔직한 메모

KREAM의 공식 API가 아니며 KREAM과 제휴 관계도 없습니다.
즉시 구매가는 사이트가 공개하는 최저 판매 희망가입니다. 실제 체결가와 항상 같지는 않습니다.
시세 그래프는 KREAM이 공개하는 기간만 제공합니다. 그보다 오래된 구간은 사이트에도 없습니다.
캐시는 없습니다. 모든 호출이 조회 시점의 상태를 보여 줍니다.