Search

Search API, बिना स्ट्रक्चर वाली टेक्स्ट क्वेरी के आधार पर Freebase का डेटा ऐक्सेस करने की सुविधा देता है. ज़्यादा जानकारी के लिए, कृपया Search की खास जानकारी और Search कुकबुक देखें. इससे आपको खोज क्वेरी को ज़्यादा जानकारी के साथ बनाने का तरीका पता चलेगा.

अनुरोध

एचटीटीपी अनुरोध

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

पैरामीटर

यहां दिए गए सभी पैरामीटर का इस्तेमाल करना या न करना आपकी ज़रूरत पर तय करता है. हालांकि, आपके पास query या filter में से कोई एक पैरामीटर होना चाहिए.

पैरामीटर का नाम मान ब्यौरा
ज़रूरी नहीं पैरामीटर
as_of_time string mql_output क्वेरी के साथ इस्तेमाल करने के लिए, एमक्यूएल as_of_time वैल्यू.
callback string JSONP कॉलबैक के लिए JS तरीके का नाम.
cursor integer cursor पैरामीटर और limit पैरामीटर की मदद से, एक बार में तय किए गए नतीजों की संख्या के हिसाब से पेज पर आगे बढ़ा जा सकता है. उदाहरण के लिए, अगर आपको लगातार 10 नतीजों वाले तीन पेज दिखाने हैं, तो  limit=10 और cursor=0 का इस्तेमाल करें. इसके बाद, cursor=10 और cursor=20 का इस्तेमाल करें.
domain string इस Freebase डोमेन आईडी वाले विषयों तक सीमित करें.
encode string जवाब की एन्कोडिंग. एचटीएमएल एन्कोडिंग चालू करने के लिए, इस पैरामीटर का इस्तेमाल किया जा सकता है.

इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "html": एचटीएमएल एन्कोडिंग का इस्तेमाल करके, जवाब में मौजूद कुछ वर्णों (जैसे कि टैग और ऐंपरसैंड) को एन्कोड करें.
  • "off": जवाब को एन्कोड नहीं किया गया है. आपको कॉन्टेंट को एचटीएमएल-एस्केप किए बिना, नतीजों को सीधे वेब पेज पर प्रिंट नहीं करना चाहिए. (डिफ़ॉल्ट)
exact boolean सिर्फ़ सही नाम और कुंजियों के बारे में क्वेरी करें.
filter string

filter पैरामीटर की मदद से, क्वेरी पर लागू करने के लिए ज़्यादा मुश्किल नियम और शर्तें बनाई जा सकती हैं.

filter वैल्यू एक सामान्य भाषा है. इसमें इन सिंबल का इस्तेमाल किया जा सकता है:

  • all, any, should, और not ऑपरेटर
  • type, domain, name, alias, with, और without ऑपरेंड
  • ग्रुप बनाने और प्राथमिकता तय करने के लिए, ( और ) ब्रैकेट

filter प्रॉपर्टी इस्तेमाल करने का तरीका जानने के लिए, Search Cookbook देखें.
format string JSON रिस्पॉन्स का स्ट्रक्चरल फ़ॉर्मैट.

इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "entity": इकाइयों के बारे में बुनियादी जानकारी. (डिफ़ॉल्ट)
  • "ids": Freebase ids की क्रम से लगाई गई सूची.
  • "mids": Freebase mids की क्रम से लगाई गई सूची.
indent boolean JSON नतीजों को इंडेंट करना है या नहीं.
lang string क्वेरी को किस भाषा में चलाना है, उसका कोड. डिफ़ॉल्ट वैल्यू 'en' होती है.
limit integer ज़्यादा से ज़्यादा कितने नतीजे दिखाने हैं. डिफ़ॉल्ट रूप से, खोज के नतीजों में 20 मैच दिखाए जाते हैं. ये मैच, खोज क्वेरी से मिलते-जुलते होने के क्रम में दिखाए जाते हैं. हालांकि, ऐसा तब होता है, जब खोज क्वेरी से मिलते-जुलते 20 मैच मौजूद हों. limit पैरामीटर का इस्तेमाल करके, कम या ज़्यादा मैच का अनुरोध किया जा सकता है. इसके लिए, आपको पैरामीटर की वैल्यू बदलनी होगी. (उदाहरण.)
mql_output string ज़्यादा डेटा निकालने के लिए, नतीजों के आधार पर फिर से चलाई जाने वाली MQL क्वेरी. क्वेरी चलाने के बाद, मैच करने वाले दस्तावेज़ों के आईडी, mql_output MQL क्वेरी को पास किए जाते हैं, ताकि मैच के बारे में असल डेटा वापस पाया जा सके. एमक्यूएल के नतीजों को, काम के स्कोर के हिसाब से घटते क्रम में लगाया जाता है. 
prefixed boolean नाम और उपनामों के हिसाब से प्रीफ़िक्स मैच.
query string खोज के लिए क्वेरी टर्म.
scoring string इस्तेमाल किया जाने वाला, काम के होने के हिसाब से स्कोरिंग करने वाला एल्गोरिदम.

इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "entity": Freebase और लोकप्रियता के आधार पर एंटिटी की रैंकिंग का इस्तेमाल करें. (डिफ़ॉल्ट)
  • "freebase": Freebase की एंटिटी रैंकिंग का इस्तेमाल करें.
  • "schema": प्रॉपर्टी और टाइप के लिए, स्कीमा रैंकिंग का इस्तेमाल करें.
spell string 'क्या आपका मतलब यह है' सुझावों के लिए अनुरोध करें

इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "always": कम से कम तीन वर्णों वाली किसी भी क्वेरी के लिए, स्पेलिंग के सुझाव पाने का अनुरोध करें.
  • "no_results": अगर कोई नतीजा नहीं मिला, तो स्पेलिंग के सुझाव पाने का अनुरोध करें.
  • "no_spelling": वर्तनी के सुझाव न दें. (डिफ़ॉल्ट)
stemmed boolean स्टेम किए गए नामों और उपनामों के बारे में क्वेरी. इसका इस्तेमाल prefixed के साथ नहीं किया जा सकता.
type string इस Freebase टाइप आईडी वाले विषयों तक सीमित करें.
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
}