Cerca

L'API Search fornisce l'accesso ai dati di Freebase tramite una query di testo senza costi. Consulta la Panoramica della ricerca e il Libro di ricette per la ricerca per ulteriori informazioni su come creare query di ricerca dettagliate.

Risorse richieste:

Richiesta HTTP

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

Parametri

Tutti i parametri seguenti sono facoltativi, ma devi avere una query o un filtro.

Nome del 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 e il parametro limit consentono di sfogliare un numero definito di risultati alla volta. Ad esempio, per presentare 3 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 utilizzarlo per attivare la codifica HTML.

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

Il parametro filter 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 informazioni su come utilizzare la proprietà filter, consulta il Libro di ricette per la ricerca.
format string Formato strutturale della risposta JSON.

I valori accettati sono:
  • "entity": informazioni di base sulle entità. (valore predefinito)
  • "ids": elenco ordinato di Freebase ids.
  • "mids": elenco ordinato di Freebase mids.
indent boolean Indica se applicare o meno un rientro ai risultati JSON.
lang string Il codice della lingua con cui eseguire la query. Il valore predefinito è 'en'.
limit integer Numero massimo di risultati da restituire. Per impostazione predefinita, vengono restituite 20 corrispondenze in ordine decrescente di pertinenza, se ne esistono molte. È possibile richiedere meno o più corrispondenze usando il parametro limit con un valore diverso. (Esempio).
mql_output string La query MQL da eseguire riesegui i risultati per estrarre più dati. Una volta eseguita la query, gli ID dei documenti corrispondenti vengono passati alla query MQL di mql_output per recuperare i dati effettivi sulle corrispondenze. I risultati di MQL vengono ordinati in base al punteggio di pertinenza decrescente. 
prefixed boolean La corrispondenza del prefisso con i nomi e gli alias.
query string Termine di ricerca da cercare.
scoring string Algoritmo di punteggio della pertinenza da utilizzare.

I valori accettati sono:
  • "entity": utilizza il ranking di entità base e popolarità Freebase. (valore predefinito)
  • "freebase": utilizza il ranking di entità Freebase.
  • "schema": utilizza il ranking dello schema per le proprietà e i tipi.
spell string Richiesta 'Forse intendevi' suggerimenti

I valori accettati sono:
  • "always": richiedi suggerimenti ortografici per qualsiasi query di almeno tre caratteri.
  • "no_results": richiedi suggerimenti ortografici se non è stato trovato alcun risultato.
  • "no_spelling": non chiedere suggerimenti ortografici. (valore predefinito)
stemmed boolean Query su nomi e alias derivati. Non utilizzabile con prefixed.
type string Limita agli argomenti con questo ID tipo Freebase.
with string Una regola di filtro con cui trovare una corrispondenza.
without string Una regola di filtro con cui non trovare una corrispondenza.

Corpo della richiesta

Non fornire un corpo della richiesta con questo metodo.

Risposta

Se l'operazione ha 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
}