검색

검색 API는 자유 텍스트 쿼리가 주어지면 Freebase 데이터에 대한 액세스를 제공합니다. 자세한 검색 쿼리를 구성하는 방법에 대한 자세한 내용은 검색 개요 및 검색 쿡북을 참고하세요.

요청

HTTP 요청

GET https://www.googleapis.com/freebase/v1/search

매개변수

아래의 모든 매개변수는 선택사항이지만 query 또는 filter 중 하나는 있어야 합니다.

매개변수 이름 값 설명
선택적 매개변수
as_of_time string mql_output 쿼리와 함께 사용할 MQL as_of_time 값입니다.
callback string JSONP 콜백의 JS 메서드 이름입니다.
cursor integer cursor 매개변수와 limit 매개변수를 사용하면 한 번에 정의된 수의 결과를 페이지로 나눌 수 있습니다. 예를 들어 연속된 10개의 결과로 구성된 3페이지를 표시하려면 limit=10 및 cursor=0, cursor=10, cursor=20를 사용합니다.
domain string 이 Freebase 도메인 ID가 있는 주제로 제한합니다.
encode string 대답의 인코딩입니다. 이 매개변수를 사용하여 HTML 인코딩을 사용 설정할 수 있습니다.

허용되는 값은 다음과 같습니다.
  • 'html': HTML 인코딩을 사용하여 대답의 특정 문자 (예: 태그 및 앰퍼샌드)를 인코딩합니다.
  • 'off': 응답이 인코딩되지 않습니다. 먼저 콘텐츠를 HTML 이스케이프하지 않고 웹페이지에 결과를 직접 인쇄해서는 안 됩니다. (기본)
exact boolean 정확한 이름과 키만 쿼리합니다.
filter string

filter 매개변수를 사용하면 쿼리에 적용할 더 복잡한 규칙과 제약 조건을 만들 수 있습니다.

filter 값은 다음 기호를 지원하는 간단한 언어입니다.

  • all, any, should, not 연산자
  • type, domain, name, alias, with, without 피연산자
  • 그룹화 및 우선순위를 위한 ( 및 ) 괄호

filter 속성을 사용하는 방법을 알아보려면 검색 쿡북을 참고하세요.
format string JSON 응답의 구조 형식입니다.

허용되는 값은 다음과 같습니다.
  • 'entity': 항목에 관한 기본 정보입니다. (기본)
  • 'ids': Freebase ids의 순서가 지정된 목록입니다.
  • 'mids': Freebase mids의 순서가 지정된 목록입니다.
indent boolean JSON 결과를 들여쓸지 여부입니다.
lang string 쿼리를 실행할 언어의 코드입니다. 기본값은 'en'입니다.
limit integer 반환할 결과의 최대 수입니다. 기본적으로 관련성이 높은 순으로 20개의 일치 항목이 반환됩니다(해당하는 경우). 다른 값을 사용하여 limit 매개변수를 사용하면 일치 항목을 더 적게 또는 더 많이 요청할 수 있습니다. (예)
mql_output string 결과에 대해 실행하여 추가 데이터를 추출할 MQL 쿼리입니다. 쿼리가 실행되면 일치하는 문서의 ID가 mql_output MQL 쿼리에 전달되어 일치 항목에 관한 실제 데이터를 가져옵니다. MQL 결과는 관련성 점수가 높은 순으로 정렬됩니다. 
prefixed boolean 이름 및 별칭에 대한 접두사 일치입니다.
query string 검색할 검색어입니다.
scoring string 사용할 관련성 점수 알고리즘입니다.

허용되는 값은 다음과 같습니다.
  • 'entity': Freebase 및 인기 항목 순위 지정 사용 (기본)
  • 'freebase': Freebase 항목 순위를 사용합니다.
  • 'schema': 속성 및 유형에 스키마 순위를 사용합니다.
spell string '다음과 같은 단어를 찾으셨나요?' 제안 요청

허용되는 값은 다음과 같습니다.
  • 'always': 3자 이상의 검색어에 대한 맞춤법 제안을 요청합니다.
  • 'no_results': 검색 결과가 없는 경우 맞춤법 제안을 요청합니다.
  • 'no_spelling': 맞춤법 제안을 요청하지 않습니다. (기본)
stemmed boolean 어간이 추출된 이름과 별칭에 대한 쿼리 prefixed와 함께 사용할 수 없습니다.
type string 이 Freebase 유형 ID가 있는 주제로 제한합니다.
with string 일치시킬 필터 규칙입니다.
without string 일치하지 않는 필터 규칙입니다.

요청 본문

이 메소드를 사용할 때는 요청 본문을 제공하지 마세요.

응답

성공하면 응답은 JSON 구조입니다. 

{
  "status":"200 OK",
  "result":[
    {
      "mid":"/m/0b1zz",
      "name":"Nirvana",
      "notable":{"name":"Record Producer","id":"/music/producer"},
      "score":55.227268
    },{
      "mid":"/m/05b3c",
      "name":"Nirvana",
      "notable":{"name":"Belief","id":"/religion/belief"},
      "score":44.248726
    },{
      "mid":"/m/01h89tx",
      "name":"Nirvana",
      "notable":{"name":"Musical Album","id":"/music/album"},
      "score":30.371510
    },{
      "mid":"/m/01rn9fm",
      "name":"Nirvana",
      "notable":{"name":"Musical Group","id":"/music/musical_group"},
      "score":30.092449
    },{
      "mid":"/m/02_6qh",
      "name":"Nirvana",
      "notable":{"name":"Film","id":"/film/film"},
      "score":29.003593
    },{
      "mid":"/m/01rkx5",
      "name":"Nirvana Sutra",
      "score":21.344824
    }
  ],
  "cost":10,
  "hits":0
}