Penelusuran

Search API menyediakan akses ke data Freebase berdasarkan kueri teks bebas. Lihat Ringkasan Penelusuran dan Panduan Penelusuran untuk mengetahui informasi selengkapnya tentang cara membuat kueri penelusuran yang mendetail.

Permintaan

Permintaan HTTP

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

Parameter

Semua parameter di bawah bersifat opsional, tetapi Anda harus memiliki salah satu dari query atau filter.

Nama parameter Nilai Deskripsi
Parameter opsional
as_of_time string Nilai MQL as_of_time yang akan digunakan dengan kueri mql_output.
callback string Nama metode JS untuk callback JSONP.
cursor integer Parameter cursor bersama dengan parameter limit memungkinkan Anda membuka halaman sejumlah hasil yang ditentukan sekaligus. Misalnya, untuk menampilkan 3 halaman dari 10 hasil berturut-turut, gunakan  limit=10 dan cursor=0, lalu cursor=10, dan cursor=20.
domain string Batasi ke topik dengan ID domain Freebase ini.
encode string Encoding respons. Anda dapat menggunakan parameter ini untuk mengaktifkan encoding HTML.

Nilai yang dapat diterima adalah:
  • "html": Mengenkode karakter tertentu dalam respons (seperti tag dan ampersand) menggunakan encoding HTML.
  • "off": Tidak ada encoding respons. Anda tidak boleh mencetak hasil secara langsung di halaman web tanpa melakukan escape HTML pada konten terlebih dahulu. (default)
exact boolean Kueri hanya pada nama dan kunci yang persis.
filter string

Parameter filter memungkinkan Anda membuat aturan dan batasan yang lebih kompleks untuk diterapkan pada kueri.

Nilai filter adalah bahasa sederhana yang mendukung simbol berikut:

  • operator all, any, should, dan not
  • operan type, domain, name, alias, with, dan without
  • tanda kurung ( dan ) untuk pengelompokan dan prioritas

Untuk mempelajari cara menggunakan properti filter, lihat Search Cookbook.
format string Format struktural respons JSON.

Nilai yang dapat diterima adalah:
  • "entity": Informasi dasar tentang entitas. (default)
  • "ids": Daftar berurutan ids Freebase.
  • "mids": Daftar berurutan mids Freebase.
indent boolean Apakah hasil JSON akan diindentasi atau tidak.
lang string Kode bahasa yang akan digunakan untuk menjalankan kueri. Default-nya adalah 'en'.
limit integer Jumlah hasil maksimum yang akan ditampilkan. Secara default, 20 kecocokan dalam urutan menurun berdasarkan relevansi akan ditampilkan, jika ada sebanyak itu. Lebih sedikit atau lebih banyak kecocokan dapat diminta dengan menggunakan parameter limit dengan nilai yang berbeda. (Contoh.)
mql_output string Kueri MQL yang akan dijalankan terhadap hasil untuk mengekstrak lebih banyak data. Setelah kueri dijalankan, ID dokumen yang cocok akan diteruskan ke kueri MQL mql_output untuk mengambil data sebenarnya tentang kecocokan. Hasil MQL diurutkan berdasarkan skor relevansi yang menurun. 
prefixed boolean Pencocokan awalan dengan nama dan alias.
query string Istilah kueri yang akan ditelusuri.
scoring string Algoritma pemberian skor relevansi yang akan digunakan.

Nilai yang dapat diterima adalah:
  • "entity": Menggunakan Freebase dan peringkat entitas popularitas. (default)
  • "freebase": Menggunakan peringkat entitas Freebase.
  • "schema": Gunakan peringkat skema untuk properti dan jenis.
spell string Meminta saran 'maksud Anda'

Nilai yang dapat diterima adalah:
  • "always": Minta saran ejaan untuk kueri apa pun yang panjangnya minimal tiga karakter.
  • "no_results": Minta saran ejaan jika tidak ada hasil yang ditemukan.
  • "no_spelling": Jangan meminta saran ejaan. (default)
stemmed boolean Kueri pada nama dan alias yang telah di-stem. Mungkin tidak dapat digunakan dengan prefixed.
type string Batasi ke topik dengan ID jenis Freebase ini.
with string Aturan filter yang akan dicocokkan.
without string Aturan filter yang tidak cocok.

Isi permintaan

Jangan berikan isi permintaan dengan metode ini.

Respons

Jika berhasil, responsnya adalah struktur 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
}