{"openapi":"3.1.0","info":{"title":"Agence 공개 API","version":"1.0.0","description":"Agence는 여러 쇼핑몰의 상품을 판매처별 가격, 정규화된 스펙, 용도별 추천과 함께 비교해 보여주는 쇼핑 정보 플랫폼입니다. 읽기 전용이며 인증이 필요 없습니다."},"servers":[{"url":"https://agence.kr"}],"paths":{"/api/v1/products":{"get":{"operationId":"searchProducts","summary":"상품 검색","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"상품명·브랜드 검색어"},{"name":"category","in":"query","schema":{"type":"string"},"description":"카테고리 slug (예: hiking-shoes)"},{"name":"max_price","in":"query","schema":{"type":"integer"},"description":"최대 가격(원)"},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":100}}],"responses":{"200":{"description":"검색 결과","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","format":"uri"},"markdown_url":{"type":"string","format":"uri"},"title":{"type":"string"},"brand":{"type":["string","null"]},"model":{"type":["string","null"]},"gtin":{"type":["string","null"]},"category":{"type":["object","null"],"properties":{"slug":{"type":"string"},"name":{"type":"string"}}},"price":{"type":"object","properties":{"amount":{"type":"integer","description":"원 단위 정수"},"currency":{"type":"string","example":"KRW"},"tax_included":{"type":"boolean"}},"description":"재고 있는 판매처 중 최저가"},"availability":{"type":"string","enum":["in_stock","out_of_stock"]},"attributes":{"type":"array","items":{"type":"object","properties":{"key":{"type":["string","null"]},"label":{"type":"string"},"value":{},"unit":{"type":["string","null"]}}}},"offers":{"type":"array","items":{"type":"object","properties":{"merchant":{"type":"string"},"price":{"type":"object","properties":{"amount":{"type":"integer","description":"원 단위 정수"},"currency":{"type":"string","example":"KRW"},"tax_included":{"type":"boolean"}}},"shipping_fee":{"type":["integer","null"]},"shipping_days":{"type":["integer","null"]},"availability":{"type":"string","enum":["in_stock","out_of_stock"]},"buy_url":{"type":"string","format":"uri","description":"구매 링크(판매처로 이동)"},"price_checked_at":{"type":"string","format":"date-time"},"affiliate":{"type":"boolean","description":"제휴 링크 여부"}}}},"content":{"type":["object","null"],"properties":{"summary":{"type":"string"},"fit_for":{"type":"array","items":{"type":"string"}},"use_cases":{"type":"array","items":{"type":"string"}},"pros":{"type":"array","items":{"type":"string"}},"cons":{"type":"array","items":{"type":"string"}},"faq":{"type":"array","items":{"type":"object","properties":{"q":{"type":"string"},"a":{"type":"string"}}}}}}}}},"count":{"type":"integer"}}}}}},"404":{"description":"카테고리 없음","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"suggestion":{"type":"object"}}}}}}}}}}},"/api/v1/products/{id}":{"get":{"operationId":"getProduct","summary":"상품 상세(판매처별 가격, 정규화 속성, 추천 정보)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"상품 id 또는 slug"}],"responses":{"200":{"description":"상품","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","format":"uri"},"markdown_url":{"type":"string","format":"uri"},"title":{"type":"string"},"brand":{"type":["string","null"]},"model":{"type":["string","null"]},"gtin":{"type":["string","null"]},"category":{"type":["object","null"],"properties":{"slug":{"type":"string"},"name":{"type":"string"}}},"price":{"type":"object","properties":{"amount":{"type":"integer","description":"원 단위 정수"},"currency":{"type":"string","example":"KRW"},"tax_included":{"type":"boolean"}},"description":"재고 있는 판매처 중 최저가"},"availability":{"type":"string","enum":["in_stock","out_of_stock"]},"attributes":{"type":"array","items":{"type":"object","properties":{"key":{"type":["string","null"]},"label":{"type":"string"},"value":{},"unit":{"type":["string","null"]}}}},"offers":{"type":"array","items":{"type":"object","properties":{"merchant":{"type":"string"},"price":{"type":"object","properties":{"amount":{"type":"integer","description":"원 단위 정수"},"currency":{"type":"string","example":"KRW"},"tax_included":{"type":"boolean"}}},"shipping_fee":{"type":["integer","null"]},"shipping_days":{"type":["integer","null"]},"availability":{"type":"string","enum":["in_stock","out_of_stock"]},"buy_url":{"type":"string","format":"uri","description":"구매 링크(판매처로 이동)"},"price_checked_at":{"type":"string","format":"date-time"},"affiliate":{"type":"boolean","description":"제휴 링크 여부"}}}},"content":{"type":["object","null"],"properties":{"summary":{"type":"string"},"fit_for":{"type":"array","items":{"type":"string"}},"use_cases":{"type":"array","items":{"type":"string"}},"pros":{"type":"array","items":{"type":"string"}},"cons":{"type":"array","items":{"type":"string"}},"faq":{"type":"array","items":{"type":"object","properties":{"q":{"type":"string"},"a":{"type":"string"}}}}}}}}}}},"404":{"description":"상품 없음","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"suggestion":{"type":"object"}}}}}}}}}}},"/api/v1/collections":{"get":{"operationId":"listCollections","summary":"비교·구매 가이드 목록","responses":{"200":{"description":"목록"}}}},"/feeds/products.jsonl":{"get":{"operationId":"productFeed","summary":"전체 상품 피드(JSON Lines)","parameters":[{"name":"updated_since","in":"query","schema":{"type":"string","format":"date-time"},"description":"이 시각 이후 바뀐 상품만"}],"responses":{"200":{"description":"한 줄에 상품 하나","content":{"application/x-ndjson":{}}}}}}}}