검색

Search API는 자유 텍스트 쿼리에 따라 Freebase 데이터에 대한 액세스를 제공합니다. 세부 검색어를 구성하는 방법에 대한 자세한 내용은 검색 개요 및 검색 설명서를 참고하세요.

요청

HTTP 요청

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

매개변수

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

매개변수 이름 값 설명
선택적 매개변수
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 쿼리를 실행할 때 사용하는 언어의 코드입니다. 기본값은 '&'입니다.
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
}