APM 상품 라이브러리 검색 API

APM 상품 라이브러리의 공개 검색 API 모음 (인증 불필요). 자연어/이미지로 동대문 상품을 벡터 유사도 검색합니다.

공통 규약

• Base URL: https://worker.apmzoom.ai (Cloudflare Worker)
• 인증: 공개 인터페이스, 인증 헤더 불필요 (is_public: true)
• Method: POST
• Content-Type: application/json
• 응답 포맷 (lite): 가격 / 재고 / 평점 / 판매량 필드 미포함. 판매자 정보는 merchant_name과 매장 층/호수(layer_id, door_no)만 유지
• 정렬: 벡터 유사도(score) 내림차순
• 카테고리 필터: category_l1_id (1차 카테고리)
• 반환 개수: limit (1-100, 기본 20)

엔드포인트 목록 (2개)

• products_search_by_text_lite — 텍스트 검색 - 간소화 · POST https://worker.apmzoom.ai/api/v1/products/search/by-text-lite
  • 자연어 쿼리(예: "검은색 패딩")를 desc_embedding 컬럼에 인코딩하여 검색
• products_search_by_image_lite — 이미지 검색 - 간소화 · POST https://worker.apmzoom.ai/api/v1/products/search/by-image-lite
  • 이미지 URL 기반 유사 상품 검색
  • embedding 옵션: default (image_embedding) 또는 fashion (image_embedding_fashion, 의류 전용)

호출 예시

# 텍스트 검색
curl -X POST https://worker.apmzoom.ai/api/v1/products/search/by-text-lite \
  -H "Content-Type: application/json" \
  -d '{"text":"검은색 패딩","limit":20,"category_l1_id":1}'

# 이미지 검색
curl -X POST https://worker.apmzoom.ai/api/v1/products/search/by-image-lite \
  -H "Content-Type: application/json" \
  -d '{"image_url":"https://image.apmzoom.ai/products/main/158236.jpg","limit":20,"embedding":"fashion"}'

사용 시나리오

• 에이전트가 사용자 발화("얇은 겉옷 추천")를 받아 텍스트 검색으로 후보 상품 목록 생성
• 업로드된 이미지로 동일/유사 상품 찾기 (스타일 매칭)
• 가격·재고 정보가 불필요한 추천/탐색 시나리오에 최적화된 경량 응답

관련 스킬

• 인증이 필요한 상품 관리 API: apmzoom-gds
• 로그인/토큰 발급: apmzoom-ids

원본 문서: https://github.com/apmzoom-ai/apm-skills