Cerca

L'API Search fornisce l'accesso ai dati di Freebase data una query di testo libero. Per saperne di più su come creare query di ricerca dettagliate, consulta Panoramica della ricerca e Ricettario della ricerca.

Richiesta

Richiesta HTTP

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

Parametri

Tutti i parametri riportati di seguito sono facoltativi, ma devi specificare query o filter.

Nome parametro Valore Descrizione
Parametri facoltativi
as_of_time string Un valore as_of_time MQL da utilizzare con le query mql_output.
callback string Nome del metodo JS per i callback JSONP.
cursor integer Il parametro cursor insieme al parametro limit consente di scorrere un numero definito di risultati alla volta. Ad esempio, per presentare tre pagine di 10 risultati successivi, utilizza limit=10 e cursor=0, poi cursor=10 e cursor=20.
domain string Limita agli argomenti con questo ID dominio Freebase.
encode string La codifica della risposta. Puoi utilizzare questo parametro per attivare la codifica HTML.

I valori accettati sono:
  • "html": codifica determinati caratteri nella risposta (ad esempio tag e e commerciali) utilizzando la codifica HTML.
  • "off": nessuna codifica della risposta. Non devi stampare i risultati direttamente su una pagina web senza prima eseguire l'escape HTML dei contenuti. (predefinito)
exact boolean Query solo su nome e chiavi esatti.
filter string

Il parametro filter ti consente di creare regole e vincoli più complessi da applicare alla query.

Il valore filter è un linguaggio semplice che supporta i seguenti simboli:

  • gli operatori all, any, should e not
  • gli operandi type, domain, name, alias, with e without
  • le parentesi ( e ) per il raggruppamento e la precedenza

Per scoprire come utilizzare la proprietà filter, consulta il Search Cookbook.
format string Formato strutturale della risposta JSON.

I valori accettati sono:
  • "entity": informazioni di base sulle entità. (predefinito)
  • "ids": elenco ordinato di ids di Freebase.
  • "mids": elenco ordinato di mids di Freebase.
indent boolean Indica se rientrare o meno i risultati JSON.
lang string Il codice della lingua con cui eseguire la query. Il valore predefinito è "en".
limit integer Il numero massimo di risultati da restituire. Per impostazione predefinita, vengono restituite 20 corrispondenze in ordine decrescente di pertinenza, se ne esistono così tante. È possibile richiedere un numero maggiore o minore di corrispondenze utilizzando il parametro limit con un valore diverso. (Esempio.)
mql_output string La query MQL da eseguire sui risultati per estrarre altri dati. Dopo l'esecuzione della query, gli ID dei documenti corrispondenti vengono passati alla query MQL mql_output per recuperare i dati effettivi sulle corrispondenze. I risultati MQL sono ordinati in base al punteggio di pertinenza decrescente. 
prefixed boolean Corrispondenza del prefisso con nomi e alias.
query string Termine di query da cercare.
scoring string Algoritmo di assegnazione del punteggio di pertinenza da utilizzare.

I valori accettati sono:
  • "entity": utilizza Freebase e il ranking delle entità in base alla popolarità. (predefinito)
  • "freebase": utilizza la classificazione delle entità Freebase.
  • "schema": utilizza il ranking dello schema per proprietà e tipi.
spell string Richiedi suggerimenti "Forse intendevi dire"

I valori accettabili sono:
  • "always": richiedi suggerimenti ortografici per qualsiasi query di almeno tre caratteri.
  • "no_results": richiedi suggerimenti ortografici se non sono stati trovati risultati.
  • "no_spelling": non richiedere suggerimenti ortografici. (predefinito)
stemmed boolean Esegui query su nomi e alias con stemming. Non può essere utilizzato con prefixed.
type string Limita agli argomenti con questo ID tipo Freebase.
with string Una regola di filtro a cui abbinare.
without string Una regola di filtro da non abbinare.

Corpo della richiesta

Non fornire un corpo della richiesta con questo metodo.

Risposta

In caso di esito positivo, la risposta è una struttura 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
}