검색 파라미터
검색 파라미터
Marqo의 /search에는 결과를 제어하는 파라미터가 여럿 있어요. 상업용 검색 시나리오에서 자주 쓰는 것들만 정리하면 다음과 같아요.
| 파라미터 | 타입 | 기본값 | 설명 |
|---|---|---|---|
limit |
Integer | 10 | 반환할 최대 문서 수 |
offset |
Integer | 0 | 건너뛸 문서 수(페이지네이션) |
filter |
String | null | Marqo 쿼리 DSL로 결과를 좁히는 필터 |
attributesToRetrieve |
List[String] | 핵심 필드 | 반환할 문서 필드 목록 |
facets |
Dict | null | 패싯(faceted search) 설정 |
가격대와 재고 필터는 이렇게 적용해요.
curl -X POST https://api.marqo.ai/api/v1/indexes/{index_name}/search \
-H "x-marqo-index-id: {index_id}" \
-H "Content-Type: application/json" \
-d '{"q": "...", "filter": "price:[* TO 100] AND inStock:true"}'
Sort, 패싯, "search as you type"(입력하며 실시간 검색) 같은 기능도 같은 검색 API 위에서 지원돼요. facets는 특정 필드 기준으로 문서를 집계해 필터·분포·드릴다운에 활용할 수 있어요.