네이버 클라우드 플랫폼의 상품 사용 방법을 보다 상세하게 제공하고, 다양한 API의 활용을 돕기 위해 [설명서]와 [API 참조서]를 구분하여 제공하고 있습니다.

Cloud Search API 참조서 바로가기 >>
Cloud Search 설명서 바로가기 >>

Search Query

summary

• 검색을 위한 SearchAPI를 제공합니다.
• 검색 서비스 구성을 위해서는 검색 기본 지식이 필요합니다.
• 서비스 생성 시 설정한 문서 설정, 색인 설정(Schema config)으로 검색 수행

REQUEST BODY SEARCH

• HTTP POST method로 검색 요청
• JSON 형태의 queryDSL 사용

overview

{
  "start": (string|int),

  "display": (string|int),

  "result_format": (string),

  "search": {
    "[index_name]": {
      "[query_method]": [{
        "query": (string),
        "name": (string),
        "type": (string),
        "option": (string|bool),
        "ratio": (string|double),
        "term_extractor": (string),
        "syno": (bool)
      }]
    }
  },

  "sort": {
    "[sort_target]": (string)
  },

  "scope": {
    "[scope_target]": {
      "[scope_method]": (string|int|double|array)
    }
  },

  "key_scope": {
    "[scope_method]": (string|array)
  },

  "user_scope": (string),

  "highlighting": {
    "enable": (string|bool),
    "pre_tag": (string),
    "post_tag": (string),
    "[highlighting_option]": (string|bool)
  },

  "display_section": (string|array),
  "passage": {
    "[section_name]": {
       "passage_type": (string),
       "passage_option": (string),
       "max_length": (string)
    },
  },

  "aggregate": {
    "[docprop_name]": {
      "max": (string),
      "min": (string),
      "one": (string),
      "sum": (string)
    }
  },

  "result_processing": {
    "[section_name]": {
      "remove_duplicate": (string|bool)
    }
  },

  "setting": {
    "transfer_timeout": (string|int),
    "search_timeout": (string|int),
    "use_df": (string|bool),
    "reuse_term_extractor": (string|bool),
    "log_level": (string|list),
  }
}

start / display

검색 결과를 보여주는 범위를 선택합니다.

Format

{
  "start": (string|int), "display": (string|int)
}

• start: 검색 결과의 시작 랭킹, 기본값은 1입니다.
• display: 검색 결과의 개수, 기본값은 20입니다.

Example

{
  "start": 1, "display": 20,
  "search": {
    "body_sgmt": {
      "main": {
        "query": "검색",
      }
    }
  },
}

result_format

검색 결과의 포맷을 지정합니다. 기본값은 json 포맷입니다.

Format

{
  "result_format": (string)
}

• result_format: 검색 결과 포맷을 지정합니다. 사용가능한 값은 json, xml입니다.

Example

{
  "search": {
    "body_sgmt": {
      "main": {
        "query": "검색",
      }
    }
  },
  "result_format": "json"
}

search

검색을 위한 파라미터입니다. [index_name], [query_method]를 지정하여 검색을 수행합니다. search 파라미터는 필수 파라미터입니다.

Format

{
  "search": {
    "[index_name]": {
      "[query_method]": {
        "query": (string),
        "name": (string),
        "type": (string),
        "option": (string),
        "ratio": (string|double),
        "term_extractor": (string),
        "syno": (bool)
      }
    }
  }
}

• [index_name]: 검색할 색인 대상을 지정합니다.
• [query_method]: 검색 방식을 선택합니다.
  • main: 검색 요청 시 반드시 있어야 하며, 'main query'는 검색 결과 집합의 합집합 연산을 합니다.
  • intersection: 'main query'의 검색 결과 집합과 'intersection query'로 구한 결과 집합의 교집합 연산을 합니다.
  • scope: 'scope query'는 'intersection query'와 효과는 같지만, 문서 질의 점수(qds)에 관여하지 않습니다.
  • exclusion: 'exclusion query'는 'main, intersection, scope query'의 검색 결과와 'exclusion query'로 구한 검색 결과를 차집합 연산한 결과입니다.
  • rerank: 'rerank query'는 검색 결과에 영향을 주지 않지만, qds값 변경에 사용됩니다. 사용할 수 있는 query type은 simbst, proxrank가 있습니다.
• query: 검색 질의를 지정합니다.
• name: 검색 시 사용할 질의 이름을 지정합니다.
• type: query 타입을 지정합니다.
  • oneterm: 단어가 하나일 때 사용하며, 해당 단어를 포함한 문서를 찾습니다.
  • nterm: 단어가 여러 개일 때 사용할 수 있습니다. 해당 단어를 포함한 문서를 찾습니다. 'option' 파라미터를 사용할수 있습니다.
  • nofm: 모든 단어 중에서 'ratio' 파라미터로 주어진 비율 이상 포함된 문서를 찾습니다.
  • ebool: boolean 연산자(and, or)를 조합한 결과를 만족하는 문서를 찾습니다.
    • 사용자가 입력한 연산자를 비롯하여 복수 개의 연산자를 이용하여 검색.
    • 색인어와 연산자의 관계를 postorder 형식으로 구성하여 불표현식 작성
    • 사용 가능 연산자: AND(&), OR(|), NOT(!)
    • 검색 사용자가 직접 연산자를 입력할 수 있으며 이 경우 &, |, ! 연산자의 좌우에 공백이 포함되어 있어야 연산자로 인식한다.
  • simbst: 찾은 문서 중에서 질의 단어를 포함하는 문서는 'ratio' 파라미터로 주어진 값만큼 qds를 올립니다.
  • proxrank: 근접도(prox)를 계산합니다.
  • null: 빈 질의로 전체 문서를 검색합니다.
• option: query 타입의 옵션을 지정합니다.
  • and: 주어진 모든 단어가 포함된 문서만 찾습니다.
  • or: 주어진 단어 중 하나라도 포함된 문서를 모두 찾습니다.
• ratio: 특정 query 타입의 비율을 지정합니다. (nofm, simbst type일 때 사용)
• term_extractor: 검색 질의 텀 추출 방식을 지정합니다. 기본값은 지정된 색인의 색인 옵션입니다. 현재는 한국어만 지원합니다.
• syno: 동의어 사전의 사용여부를 선택합니다.

Example

search 파라미터에 대한 예제입니다.

• method별 예제

  • main query

    {
      "search": {
        "body_sgmt": {
          "main": {
            "query": "검색",
            "type": "nterm",
            "option": "and"
          }
        }
      }
    }
    

  • intersection query

    {
      "search": {
        "body_sgmt": {
          "main": {
            "query": "검색",
            "type": "nterm",
            "option": "and"
          },
          "intersection": {
            "query": "좋아요",
            "type": "nterm",
            "option": "and"
          }
        }
      }
    }
    

  • scope query

    {
      "search": {
        "body_sgmt": {
          "main": {
            "query": "검색",
            "type": "nterm",
            "option": "and"
          },
          "scope": {
            "query": "좋아요",
            "type": "nterm",
            "option": "and"
          }
        }
      }
    }
    

  • exclusion query

    {
      "search": {
        "body_sgmt": {
          "main": {
            "query": "검색",
            "type": "nterm",
            "option": "and"
          },
          "exclusion": {
            "query": "나빠요",
            "type": "nterm",
            "option": "and"
          }
        }
      }
    }
    

  • rerank query

    {
      "search": {
        "body_sgmt": {
          "main": {
            "query": "검색",
            "type": "nterm",
            "option": "and"
          },
          "rerank": {
            "query": "좋아요",
            "type": "simbst",
            "ratio": 0.7
          }
        }
      }
    }
    

• type별 예제

  • oneterm type

    {
      "search": {
        "body_sgmt": {
          "main": {
            "query": "검색",
            "type": "oneterm"
          }
        }
      }
    }
    

  • nterm type

    {
      "search": {
        "title_sgmt": {
          "main": {
            "query": "검색이 좋아요",
          }
        }
      }
    }
    

  • nofm type

    {
      "search": {
        "body_sgmt": {
          "main": {
            "query": "검색이 좋아요",
            "type": "nofm",
            "ratio": 0.7
          }
        }
      }
    }
    

  • ebool type

    {
      "search": {
        "body_sgmt": {
          "main": {
            "query": "검색 | 좋아요 & 싫어요 ! 안되요" ,
            "type": "ebool"
          }
        }
      }
    }
    

  • simbst type

    {
      "search": {
        "body_sgmt": {
          "main": {
            "query": "테스트"
          },
          "rerank": {
            "query": "검색",
            "type": "simbst",
            "ratio": 0.7
          }
        }
      }
    }
    

  • proxrank type

    {
      "search": {
        "title_sgmt": {
          "main": {
            "query": "테스트"
          },
          "rerank": {
            "query": "검색",
            "type": "proxrank",
            "option": "exprox"
          }
        }
      }
    }
    

  • null type

    {
      "search": {
        "body_sgmt": {
          "main": {
            "type": "null"
          }
        }
      }
    }
    

sort

검색 결과 정렬 기준을 위한 파라미터입니다. [sort_target], [sort_option]을 지정하여 검색 결과 정렬을 수행합니다.

Format

{
  "sort": {
    "[sort_target]": [sort_option](string)
  }
}

• [sort_target]: 정렬 기준을 지정합니다. (문서 속성과 랭킹 모듈의 변수를 지정할 수 잇습니다.)
• [sort_option]: 정렬 방식을 지정합니다. 사용가능한 값은 desc(내림차순), asc(오름차순)입니다.

Example

sort 파라미터 예제입니다.

{
  "search": {
    "body_sgmt": {
      "main": {
        "query": "검색",
      }
    }
  },
  "sort": {
    "dp_pubdate": "desc"
  }
}

scope

제한 검색을 위한 파라미터입니다. [scope_target], [scope_method]를 지정하여 제한 검색을 수행합니다.

Format

{
  "scope": {
    "[scope_target]": {
      "[scope_method]": (string|int|double|array)
    }
  }
}

• [scope_target]: 제한 검색 대상을 지정합니다. (문서 속성과 랭킹 모듈의 변수를 지정할 수 있습니다.)
• [scope_method]: 제한 검색 방식을 선택합니다.
  • exist, nexist: 지정한 값이 존재하는 문서 속성으로 검색 결과를 제한합니다.
  • range, nrange: 지정한 범위의 값이 존재하는 문서 속성으로 검색 결과를 제한합니다. (gte:lte)
  • gte, gt, lte, lt: 지정한 범위의 값이 존재하는 문서 속성으로 검색 결과를 제한합니다.(gte: 크거나 같다, gt: 크다, lte: 작거나 같다, lt: 작다)
  • bit, nbit: 지정한 비트의 값과 문서 속성을 연산하여 참, 거짓인 경우의 문서로 검색 결과를 제한합니다.
  • bitmask: 지정한 비트의 값과 문서 속성을 bitmask 연산하여 참인 경우의 문서로 검색 결과를 제한합니다.

Example

• exist/nexist

  {
  "search": {
    "body_sgmt": {
      "main": {
        "query": "검색",
      }
    }
  },
  "scope": {
    "dp_docprop1": {
      "exist": 1,
      "nexist": [1,2,3,4,5],
    },
    "dp_docprop2": {
      "nexist": 5
    }
  }
  }
  

• range/nrange

  {
  "search": {
    "body_sgmt": {
      "main": {
        "query": "검색",
      }
    }
  },
  "scope": {
    "dp_docprop1": {
      "range": ["1", "10"],
      "nrange": ["1", "10"]
    },
    "dp_docprop2": {
      "range": ["2", "5"]
    }
  }
  }
  

• gte/gte/lte/lt

  {
  "search": {
    "body_sgmt": {
      "main": {
        "query": "검색",
      }
    }
  },
  "scope": {
    "dp_docprop": {
      "gte": "0",
      "gt": "0",
      "lte": "1",
      "lt": "1"
    }
  }
  }
  

• bit/nbit/bitmask

  {
  "search": {
    "body_sgmt": {
      "main": {
        "query": "검색",
      }
    }
  },
  "scope": {
    "dp_docprop": {
      "bit": "11110000",
      "nbit": "10101010",
      "bitmask": "11110000"
    }
  }
  }
  

key_scope

key 제한 검색을 위한 파라미터입니다. [scope_method]를 지정하여 제한 검색을 수행합니다.

Format

{
  "key_scope": {
    "[key_scope_method]": (string|array)
  }
}

• [key_scope_method]: 문서 키에 대한 제한 검색 방식을 선택합니다.
  • exist, nexist: 지정한 문서 키에 해당 하는 문서로 검색 결과를 제한합니다.

Example

• exist/nexist

  {
  "search": {
    "body_sgmt": {
      "main": {
        "query": "검색",
      }
    }
  },
  "key_scope": {
    "exist": "A017a75c_000000000001fca5990e8e04",
    "nexist": ["A017a75c_000000000001fca5990e8e10", "A017a75c_000000000001fca5990e8e20"]
  }
  }
  

user_scope

사용자가 직접 scope 수식을 입력하기 위한 파라미터입니다.

Format

{
  "user_scope": (string)
}

• user_scope: 랭킹 코드 형태의 scope 수식을 입력합니다. 입력된 수식은 'scope' 파라미터의 내용과 and 조건으로 추가됩니다.

Example

{
  "search": {
    "body_sgmt": {
      "main": {
        "query": "검색",
      }
    }
  },
  "user_scope": "(dp_like_cnt => 100) and (dp_like_cnt <= 600)"
}

{
  "search": {
    "body_sgmt": {
      "main": {
        "query": "검색",
      }
    }
  },
  "user_scope": "(dp_grade == 1) or (dp_grade == 2)"
}

highlighting

검색 질의에 대해서 구문강조 설정을 위한 파라미터입니다.

Format

  "highlighting": {
    "enable": (string|bool),
    "pre_tag": (string),
    "post_tag": (string),
    "[highlighting_option]": (string|bool)
  }

• enable: 하이라이팅 여부를 선택합니다. 기본값은 true입니다.
• pre_tag, post_tag: 검색 시 매치되는 텀에 대해 구문강조 태그를 지정합니다. 지정하지 않으면 기본으로 <b>, </b>가 사용됩니다.
• highlighting_option: 구문강조 옵션을 지정합니다. 기본값은 false입니다.
  • remove_html_tag: 이 옵션이 활성화 상태이면 HTML 태그를 제거합니다.
  • skip_html_tag: 이 옵션이 활성화 상태이면 HTML 태그를 하이라이팅 하거나 태그에 포함된 문자를 변형하지 않고 그대로 유지합니다.
  • braket_as_tag: 이 옵션이 활성화 상태이면 <와 > 사이는 모두 HTML 태그로 간주합니다.
  • num_entity_as_char: 이 옵션이 활성화 상태이면 가과 같은 숫자형 엔티티를 문자처럼 취급한다. 하이라이팅도 해당 엔티티를 문자로 취급하여 수행합니다.
  • skip_char_entity: 이 옵션이 활성화 상태이면 문자형 엔티티를 하이라이팅하거나 포함된 문자를 변형하지 않고 그대로 유지합니다.
  • kata_to_hira: 이 옵션이 활성화 상태이면 서로 대응되는 일본어 카타카나 문자와 히라가나 문자를 같은 문자로 취급합니다.
  • bold_sub_query: 이 옵션이 활성화 상태이면 질의와 정확히 일치하는 문자열을 발견해도 부분 키워드들을 모두 하이라이팅합니다.
  • bold_sub_english: 이 옵션이 활성화 상태이면 영어 단어의 일부분이 키워드와 일치하는 경우에도 하이라이팅한다. 예를 들어, 키워드가 "a"일 때 "about"의 첫 글자 "a"를 하이라이팅합니다.
  • bold_sub_digit: 이 옵션이 활성화 상태이면 숫자의 일부분이 키워드와 일치하는 경우에도 하이라이팅한다. 예를 들어, 키워드가 "1"일 때 "12345"의 첫 숫자 "1"를 하이라이팅합니다.
  • bold_sub_hanja: 이 옵션이 활성화 상태이면 한자 하이라이팅을 제한하지 않는다.

Example

{
  "search": {
    "body_sgmt": {
      "main": {
        "query": "검색",
      }
    }
  },
  "highlighting": {
    "enable": true,
    "pre_tag": "<b>",
    "post_tag": "</b>",
    "remove_html_tag": true,
    "skip_html_tag": true,
    "num_entity_as_char": false,
    "braket_as_tag": false,
    "skip_char_entity": true,
    "kata_to_hira": false,
    "bold_sub_query": false,
    "bold_sub_english": true,
    "bold_sub_digit": true,
    "bold_sub_hanja": false,
  }
}

display_section

검색 결과를 읽는 섹션들을 지정하는 파라미터입니다. 해당 파라미터를 지정하지 않으면, 전체 섹션의 결과를 읽습니다. 섹션을 지정하면, 선택한 섹션의 결과만 읽습니다.

Format

{
  "display_section": (string|array),
}

• display_section: 기본 문서 읽기 옵션으로 읽을 섹션을 지정합니다. 여러 섹션을 조합할 수 있습니다.(예: TITLE+BODY)

Example

• display_section

  {
  "search": {
    "body_sgmt": {
      "main": {
        "query": "검색",
      }
    }
  },
  "display_section": ["TITLE","BODY","CONTENTS","TITLE+BODY"],
  "display_section": "TITLE,BODY,CONTENTS,TITLE+BODY"
  }
  

passage

검색 결과를 읽는 방식을 지정하는 파라미터입니다. 해당 파라미터를 지정하지 않으면, 전체 섹션의 결과를 읽습니다. 섹션을 지정하면, 선택한 섹션의 결과만 읽습니다.

Format

{
  "passage": {
    "[section_name]": {
       "passage_type": (string),
       "passage_option": (string),
       "max_length": (string|int)
    }
  }
}

• [section_name]: 섹션 이름을 지정합니다. 여러 섹션을 조합할 수 있습니다.(예: TITLE+BODY)
• passage_type: passage 추출 방식을 지정합니다.
  • none: 섹션의 앞 부분부터 읽습니다.
  • classic: 섹션에서 질의 색인어 주변을 읽습니다.
• passage_option: passage 추출 옵션을 지정합니다. (CBT 범위 밖입니다)
• max_length: passage 추출 길이를 지정합니다.

Example

{
  "search": {
    "body_sgmt": {
      "main": {
        "query": "검색",
      }
    }
  },
  "passage": {
    "TITLE": {
       "passage_type": "classic",
       "passage_option": "mspcnt=1;rmtag=on;",
       "max_length": 400
    },
    "TITLE+BODY": {
       "passage_type": "classic",
       "passage_option": "mspcnt=1;rmtag=on;",
       "max_length": 500
    }
  }
}

aggregate

요약 검색을 위한 파라미터입니다.

Format

{
  "aggregate": {
    "[docprop_name]": {
      "max": (string),
      "min": (string),
      "one": (string),
      "sum": (string)
    }
  }
}

• [docprop_name]: 요약 검색의 기준이되는 문서 속성을 지정합니다.
• max: 요약 검색의 max 연산 대상을 지정합니다.
• min: 요약 검색의 min 연산 대상을 지정합니다.
• one: 요약 검색의 one 연산 대상을 지정합니다.
• sum: 요약 검색의 sum 연산 대상을 지정합니다. '_1' 키워드 사용시에는 요약된 결과의 수를 구합니다.

Example

{
  "search": {
    "body_sgmt": {
      "main": {
        "query": "검색",
      }
    }
  },
  "aggregate": {
    "dp_like_cnt": {
      "max": ["dp_like_cnt", "dp_dislike_cnt"],
      "min": ["dp_like_cnt", "dp_disklike_cnt"],
      "one": "dp_like_cnt",
      "sum": "_1"
    }
  }
}

ranking

• 랭킹을 지정하는 파라미터입니다. 등록된 랭킹 모듈 이름 혹은 코드로 검색 테스트를 할 수 있습니다.

format

{
  "ranking": {
    "name": (string),
    "code": (string),
    "override_value": {
        "[ranking_value]" : (string|int|float)
    }
  }
}

example

등록된 랭킹 모듈을 선택하여 검색

{
  "search": {
    "body_sgmt": {
      "main": {
        "query": "검색",
      }
    }
  },
  "ranking": {
    "name": "clous"
  }
}

임시로 랭킹 코드를 직접 입력하여 검색

{
  "search": {
    "body_sgmt": {
      "main": {
        "query": "검색",
      }
    }
  },
  "ranking": {
    "code": "overridable quality = 0.5; _relevance = 0.3 * qds + 0.7 * quality;",
    "override_value": {
        "quality": 1.0
    }
  }
}

result_processing

검색 결과의 후처리를 지정하는 파라미터입니다. [section_name], [result_processing_method]를 지정하여 후처리를 수행합니다.

Format

{
  "result_processing": {
    "[section_name]": {
      "[result_processing_method]": (string|bool)
    }
  }
}

• [section_name]: 섹션 이름을 지정합니다.
• [result_processing_method]: 후처리 방식을 지정합니다.
  • remove_duplicate: 패시지 중복 제거를 수행합니다.

Example

{
  "search": {
    "body_sgmt": {
      "main": {
        "query": "검색",
      }
    }
  },
  "result_processing": {
    "BODY": {
      "remove_duplicate": true
    }
  }
}

setting

검색 시 기타 환경 설정을 할 수 있습니다.

Format

{
  "setting": {
    "transfer_timeout": (string|int),
    "search_timeout": (string|int),
    "ranking_value": (string|bool),
    "use_df": (string|bool),
    "reuse_term_extractor": (string|bool),
    "log_level": (string|list),
  }
}

• transfer_timeout: transfer_timeout을 지정합니다.
• search_timeout: search_timeout을 지정합니다.
• ranking_value: 결과에 랭킹 변수 값 노출 여부를 지정합니다.
• use_df: idf 값의 사용 여부를 지정합니다.
• reuse_term_extractor: term_extractor 옵션에서 생성한 텀분석기를 서버에 저장 합니다.
  • true: term_extractor 옵션을 줘서 runtime에 만든 텀분석기를 다음 요청에도 사용할 수 있도록 서버에 저장 합니다. (총 50개까지 저장 가능합니다)
  • false: term_extractor 옵션을 줘서 runtime에 만든 텀분석기를 한번 사용 후 버립니다. 디폴트 설정입니다.
    • 해당 옵션은 검색 결과에 영향을 주지 않으며, 성능에 영향을 줍니다. term_extractor 옵션을 사용해서 검색 쿼리를 만드실 예정 이라면 실제 트래픽을 받기 전에 해당 옵션을 반드시 켜시길 바랍니다. 단, 테스트시에는 텀분석기 최대 숫자인 50개가 넘을 수 있기 때문에 끄고 테스트 하시길 추천 드립니다.

Example

{
  "setting": {
    "transfer_timeout": 30,
    "search_timeout": 30,
    "ranking_value": true,
    "use_df": true,
    "reuse_term_extractor": true
  }
}

[ Uri Search ]

• HTTP GET method로 검색 요청
• Request Body format을 그대로 사용할 수 있도록 설계하였습니다.
• query string parameter에 jsonPath형태로 입력합니다.

start / display

• 검색 결과를 보여주는 범위를 선택합니다.

Format

?start=(string)
?display=(string)

Example

?start=1&display=10

result_format

• 검색 결과의 포맷을 지정합니다. 기본값은 json 포맷입니다.

Format

?result_format=(string)

Example

?result_format=json

search

• 검색을 위한 파라미터입니다.
• 필수 파라미터입니다.

Format

?search.[index_name].[query_method].query=(string)
?search.[index_name].[query_method].type=(string)
?search.[index_name].[query_method].option=(string)
?search.[index_name].[query_method].ratio=(string)
?search.[index_name].[query_method].term_extractor=(string)

Example

?search.body_sgmt.main.query=검색&search.body_sgmt.main.type=nterm&search.body_sgmt.main.option=and

sort

• 검색 결과 정렬 기준을 위한 파라미터입니다. [sort_target], [sort_option]을 지정하여 검색 결과 정렬을 수행합니다.

Format

?sort.[sort_target]=[sort_option]

Example

?sort.relevance=desc

scope

• 제한 검색을 위한 파라미터입니다. [scope_target], [scope_method]를 지정하여 제한 검색을 수행합니다.

Format

?scope.[scope_target].[scope_method]=(string)

Example

?scope.dp_grade.exist=1
?scope.dp_pubdate.range=180403,180410
?scope.dp_price.gte=777

key_scope

• key 제한 검색을 위한 파라미터입니다. [scope_method]를 지정하여 제한 검색을 수행합니다.

Format

?key_scope.[key_scope_method]=(string)

Example

?key_scope.exist=gdid_000000001
?key_scope.nexist=gdid_00000010

user_scope

• key 제한 검색을 위한 파라미터입니다. [scope_method]를 지정하여 제한 검색을 수행합니다.

Format

?user_scope=(string)

Example

?user_scope=(dp_price > 400)
?user_scope=(dp_price >= 400) and (dp_price < 1000)
?user_scope=(dp_grade == 1) and (dp_grade == 2)

highlighting

• 검색 질의에 대해서 구문강조 설정을 위한 파라미터입니다.

Format

?highlighting.enable=(string)
?highlighting.pre_tag=(string)
?highlighting.post_tag=(string)
?highlighting.[highlighting_option]=(string)

Example

?highlighting.enable=true
?highlighting.pre_tag=<b>&highlighting.post_tag=</b>
?highlighting.bold_sub_digit=true

display_section

• 검색 결과를 읽는 섹션들을 지정하는 파라미터입니다. 해당 파라미터를 지정하지 않으면, 전체 섹션의 결과를 읽습니다. 섹션을 지정하면, 선택한 섹션의 결과만 읽습니다.
• 섹션의 구분자는 " , "입니다.

Format

?display_section=(string)

Example

?display_section=BODY:TITLE

passage

• 검색 결과를 읽는 방식과 패시지 추출 옵션을 지정하는 파라미터입니다.

Format

?passage.[section_name].passage_type=(string)
?passage.[section_name].passage_option=(string)
?passage.[section_name].max_length=(string)

Example

?passage.BODY.passage_type=classic
?passage.BODY.passage_option=mspcnt=1;rmtag=on;
?passage.BODY.max_length=400

aggregate

• 요약 검색을 위한 파라미터입니다.

Format

?aggregate.[docprop_name].max=(string)
?aggregate.[docprop_name].min=(string)
?aggregate.[docprop_name].one=(string)
?aggregate.[docprop_name].sum=(string)

Example

?aggregate.dp_like_cnt.max=dp_like_cnt,dp_dislike_cnt
?aggregate.dp_like_cnt.min=dp_like_cnt,dp_type
?aggregate.dp_like_cnt.sum=_1

result_processing

• 검색 결과의 후처리를 지정하는 파라미터입니다. [section_name], [result_processing_method]를 지정하여 후처리를 수행합니다.

Format

?result_processing.[section_name].[result_processing_method]=(string)

Example

?result_processing.TITLE.remove_duplicate=true

setting

• 검색 시 기타 환경 설정을 할수 있습니다.

Format

?setting.transfer_timeout=(string)
?setting.search_timeout=(string)
?setting.use_df=(string)
?setting.reuse_term_extractor=(string)

Example

?setting.transfer_timeout=30
?setting.search_timeout=30
?setting.use_df=true
?setting.reuse_term_extractor=true