Search API cung cấp quyền truy cập vào dữ liệu Freebase dựa trên một cụm từ tìm kiếm dạng văn bản tự do. Vui lòng tham khảo Tổng quan về Tìm kiếm và Sổ tay Tìm kiếm để biết thêm thông tin về cách tạo các cụm từ tìm kiếm chi tiết.
Yêu cầu
Yêu cầu HTTP
GET https://www.googleapis.com/freebase/v1/search
Thông số
Tất cả các tham số bên dưới đều không bắt buộc nhưng bạn phải có một trong hai tham số query hoặc filter.
| Tên thông số | Giá trị | Mô tả |
|---|---|---|
| Thông số không bắt buộc | ||
as_of_time |
string |
Giá trị as_of_time MQL để dùng với các truy vấn mql_output.
|
callback |
string |
Tên phương thức JS cho các lệnh gọi lại JSONP. |
cursor |
integer |
Tham số cursor cùng với tham số limit cho phép bạn phân trang qua một số lượng kết quả xác định tại một thời điểm. Ví dụ: để trình bày 3 trang gồm 10 kết quả liên tiếp, hãy sử dụng limit=10 và cursor=0, sau đó là cursor=10 và cursor=20.
|
domain |
string |
Giới hạn ở những chủ đề có mã nhận dạng miền Freebase này. |
encode |
string |
Phương thức mã hoá của phản hồi. Bạn có thể sử dụng tham số này để bật tính năng mã hoá HTML.
Các giá trị được chấp nhận là:
|
exact |
boolean |
Chỉ truy vấn theo tên và khoá chính xác. |
filter |
string |
Tham số Giá trị
Để tìm hiểu cách sử dụng thuộc tính |
format |
string |
Định dạng cấu trúc của phản hồi JSON.
Các giá trị được chấp nhận là:
|
indent |
boolean |
Có thụt lề kết quả JSON hay không. |
lang |
string |
Mã ngôn ngữ dùng để chạy truy vấn. Giá trị mặc định là "en". |
limit |
integer |
Số lượng kết quả tối đa cần trả về. Theo mặc định, 20 kết quả trùng khớp theo thứ tự giảm dần về mức độ liên quan sẽ được trả về, nếu có đủ số lượng đó. Bạn có thể yêu cầu ít hoặc nhiều kết quả trùng khớp hơn bằng cách sử dụng tham số limit với một giá trị khác. (Ví dụ.)
|
mql_output |
string |
Truy vấn MQL để chạy lại kết quả nhằm trích xuất thêm dữ liệu. Sau khi truy vấn được chạy, mã nhận dạng của các tài liệu phù hợp sẽ được truyền đến truy vấn mql_output MQL để truy xuất dữ liệu thực tế về các kết quả trùng khớp. Kết quả MQL được sắp xếp theo điểm liên quan giảm dần.
|
prefixed |
boolean |
So khớp tiền tố với tên và biệt hiệu. |
query |
string |
Cụm từ tìm kiếm cần tìm. |
scoring |
string |
Thuật toán tính điểm mức độ liên quan cần sử dụng.
Các giá trị được chấp nhận là:
|
spell |
string |
Yêu cầu đề xuất "bạn có muốn nói"
Các giá trị được chấp nhận là:
|
stemmed |
boolean |
Truy vấn về tên và biệt hiệu đã được rút gọn. Không được dùng với prefixed.
|
type |
string |
Hạn chế đối với các chủ đề có mã loại Freebase này. |
with |
string |
Một quy tắc lọc để so khớp. |
without |
string |
Một quy tắc lọc để không khớp. |
Nội dung yêu cầu
Không cung cấp nội dung yêu cầu bằng phương thức này.
Phản hồi
Nếu thành công, phản hồi sẽ là một cấu trúc 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
}