OpenAPI 검색 API 공통사항

검색연산자 사용

검색필드가 존재하는 모든 API는 아래와 같은 검색연산자를 사용할 수 있습니다.
검색연산자 기능 검색시 예
() 우선순위가 가장 높은 연산자 예1) (나노 (기계|machine))
공백 두 개의 검색어(식)을 모두 포함하고 있는 문서 검색 예1) (나노 기계)
예2) 나노 장영실
| 두 개의 검색어(식) 중 하나 이상 포함하고 있는 문서 검색 예1) (줄기세포 | 면역)
예2) 줄기세포 | 장영실
! NOT 이후에 있는 검색어가 포함된 문서는 제외 예1) (황금 !백금)
예2) !image
* 검색어의 *란에 0개 이상의 임의의 문자가 포함된 문서 검색 semi*
"" 따옴표 내의 구문과 완전히 일치하는 문서만 검색 "Transform and Quantization"
  • 가) ( ) 연산자

    - 단일 검색필드 내에서 소괄호 연산자 ( ) 를 사용하면 괄호 안의 검색어(식)가 우선순위로 지정됩니다.
    - ex) {"BI":"나노 (기계 | machine)"}
    - 위 검색 예제에서 ‘(기계 | machine)’ 검색식은 우선적으로 연산되고, ‘나노’ 검색어와 ‘(기계 | machine)’ 검색식 결과는 AND 연산을 수행하게 됩니다.
  • 나) 공백 연산자

    - 단일 검색필드 내에서 두 개 이상의 검색어(식)을 모두 포함하고 있는 문서를 검색합니다.
    - ex) {"BI":"나노 기계"}
    - 또한, AND 연산자를 활용하여 두 개 이상의 검색어(식)을 검색할 수 있습니다. 하지만 공백 연산자는 단일 필드 내에서만 검색되며, AND 연산자는 모든 검색필드 중 한 필드에서만 존재하여도 검색 결과에 포함됩니다.
    - 예를 들어, 논문 검색 API를 사용할 경우 {"BI":"phase change"}는 두 개의 키워드가 모두 단일 검색필드 BI에서만 존재하면 검색되며, {"BI":"phase AND change"} 각각의 키워드가 검색필드 BI 외에도 TI, AU 등 다른 모든 필드에서 존재하면 검색 결과에 포함됩니다. 따라서 AND 연산자를 사용하면 더 많은 검색 결과가 반환될 수 있습니다.
  • 다) | 연산자

    - 단일 검색필드 내에서 두 개 이상의 검색어(식) 중 1개 이상을 포함하고 있는 문서를 검색합니다.
    - ex) {"BI":"나노|기계"}
  • 라) ! 연산자

    - 단일 검색필드 내에서 NOT 이후에 있는 검색어가 포함된 문서는 제외합니다.
    - ex) {"BI":"나노 !기계"}
    - 키워드간 공백이 필요하며, !와 키워드간 공백이 존재하지 않아야합니다.
  • 마) * 연산자

    - 단일 검색필드 내에서 검색어* 뒤 0개 이상의 임의의 문자가 포함된 문서를 검색합니다.
    - ex) {"BI":"나노*"}
    - 검색어 뒤에 *가 존재해야하며, 키워드와 *간 공백이 존재하지 않아야합니다.
  • 바) " " 연산자

    - 단일 검색필드 내에서 따옴표 내의 구문과 완전히 일치하는 문서만 검색합니다.
    - ex) {"BI":"\"Transform and Quantization\""}

제한사항

ScienceON API Gateway는 API 서버 안정성을 위해 클라이언트에 응답 시 검색 호출 건수를 10,000건 이하로 제한합니다. 클라이언트측으로 응답된 XML에서 TotalCount는 ScienceON 데이터베이스에 저장된 총 콘텐츠 개수이며 실제 recordList의 개수와 상이할 수 있습니다.
ScienceON에서는 사용자에게 검색어(식)들의 적절한 조합으로 10,000 미만으로 응답받을 수 있는 Query 작성을 권유합니다.