Telusuri

Search API menyediakan akses ke data Freebase dengan kueri teks gratis. Lihat Ringkasan Penelusuran dan Buku Petunjuk Penelusuran untuk 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 kueri atau filter.

Nama parameter Value Deskripsi
Parameter opsional
as_of_time string Nilai as_of_time MQL untuk digunakan dengan kueri mql_output.
callback string Nama metode JS untuk callback JSONP.
cursor integer Parameter cursor bersama dengan parameter limit memungkinkan Anda melihat halaman dalam jumlah hasil yang ditentukan dalam satu waktu. Misalnya, untuk menyajikan 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": Enkode karakter tertentu dalam respons (seperti tag dan ampersand) menggunakan encoding HTML.
  • "off": Tidak ada encoding dari respons. Anda tidak boleh mencetak hasil langsung di halaman web tanpa meng-escape konten HTML terlebih dahulu. (default)
exact boolean Kueri hanya pada nama dan kunci yang tepat.
filter string

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

Nilai filter adalah bahasa sederhana yang mendukung simbol berikut:

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

Untuk mempelajari cara menggunakan properti filter, lihat Buku resep Penelusuran.
format string Format struktural respons JSON.

Nilai yang dapat diterima adalah:
  • "entity": Informasi dasar tentang entitas. (default)
  • "ids": Daftar Urutan Freebase ids.
  • "mids": Daftar Urutan Freebase mids.
indent boolean Mengindentasi hasil JSON atau tidak.
lang string Kode bahasa yang akan digunakan untuk menjalankan kueri. Defaultnya adalah 'id'.
limit integer Jumlah hasil maksimum untuk ditampilkan. Secara default, 20 kecocokan dalam urutan relevansi yang menurun akan ditampilkan, jika ada. Kecocokan yang lebih sedikit atau lebih banyak dapat diminta dengan menggunakan parameter limit dengan nilai yang berbeda. (Contoh.)
mql_output string Kueri MQL untuk dijalankan kembali terhadap hasil untuk mengekstrak lebih banyak data. Setelah kueri dijalankan, dokumen yang cocok&#39 akan diteruskan ke kueri MQL mql_output untuk mengambil data aktual tentang kecocokan tersebut. Hasil MQL diurutkan dengan menurunkan skor relevansi. 
prefixed boolean Pencocokan awalan terhadap nama dan alias.
query string Istilah kueri yang akan ditelusuri.
scoring string Algoritme skor relevansi yang akan digunakan.

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

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 minta saran ejaan. (default)
stemmed boolean Kueri tentang stem name dan alias. 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 dengan aturan filter.

Isi permintaan

Jangan menyediakan isi permintaan dengan metode ini.

Tanggapan

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
}