Rechercher

L'API Search permet d'accéder aux données Freebase à partir d'une requête en texte libre. Pour savoir comment créer des requêtes de recherche détaillées, consultez la Présentation de la recherche Google et le Guide de recherche.

Demande

Requête HTTP

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

Paramètres

Tous les paramètres ci-dessous sont facultatifs, mais vous devez utiliser au moins l'une des valeurs suivantes : query (requête) ou filter (filtre).

Nom du paramètre	Value	Description
Paramètres facultatifs
`as_of_time`	`string`	Une valeur MQL `as_of_time` à utiliser avec les requêtes `mql_output`.
`callback`	`string`	Nom de la méthode JS pour les rappels JSONP.
`cursor`	`integer`	Les paramètres `cursor` et `limit` vous permettent de parcourir un nombre défini de résultats à la fois. Par exemple, pour présenter trois pages de 10 résultats successifs, utilisez `limit=10` et `cursor=0`, puis `cursor=10` et `cursor=20`.
`domain`	`string`	Limiter les sujets à cet ID de domaine Freebase
`encode`	`string`	Encodage de la réponse. Ce paramètre vous permet d'activer l'encodage HTML. Les valeurs autorisées sont les suivantes : "&`html`" : codez certains caractères dans la réponse (comme les tags et les esperluettes) à l'aide du code HTML. "`off`": aucun encodage de la réponse. Vous ne devez pas imprimer les résultats directement sur une page Web sans échapper le contenu au format HTML au préalable. (par défaut)
`exact`	`boolean`	Interrogez uniquement le nom et les clés exacts.
`filter`	`string`	Le paramètre `filter` vous permet de créer des règles et des contraintes plus complexes à appliquer à votre requête. La valeur `filter` est un langage simple qui accepte les symboles suivants: les opérateurs `all`, `any`, `should` et `not` les opérandes `type`, `domain`, `name`, `alias`, `with` et `without` ; Les parenthèses `(` et `)` pour le regroupement et la priorité Pour savoir comment utiliser la propriété `filter`, consultez le livre de recettes sur le Réseau de Recherche.
`format`	`string`	Format structurel de la réponse JSON. Les valeurs autorisées sont les suivantes : "`entity` : informations de base sur les entités. (par défaut) "`ids` : liste numérotée de Freebase `ids`. "`mids` : liste numérotée de Freebase `mids`.
`indent`	`boolean`	Indique si les résultats doivent être mis en retrait ou non.
`lang`	`string`	Code du langage avec lequel exécuter la requête. La valeur par défaut est '.
`limit`	`integer`	Nombre maximal de résultats à renvoyer. Par défaut, 20 correspondances par ordre de pertinence décroissant sont renvoyées, si elles existent. Il est possible d'obtenir moins d'occurrences, voire plus, du paramètre `limit` avec une valeur différente. Exemple
`mql_output`	`string`	La requête MQL à exécuter pour réévaluer les résultats afin d'extraire davantage de données Une fois la requête exécutée, les documents correspondants sont transmis à la requête MQL `mql_output` pour récupérer les données réelles sur les correspondances. Les résultats MQL sont triés par ordre décroissant de pertinence.
`prefixed`	`boolean`	Le préfixe correspond aux noms et aux alias.
`query`	`string`	Terme de recherche à rechercher.
`scoring`	`string`	Algorithme de score de pertinence à utiliser. Les valeurs autorisées sont les suivantes : "`entity` : utilisez le classement Freebase et la popularité des entités. (par défaut) "`freebase` : utilisez le classement des entités Freebase. "`schema` : utilisez le classement par schéma pour les propriétés et les types.
`spell`	`string`	Demandez les suggestions suivantes Les valeurs autorisées sont les suivantes : "`always`": demander des suggestions de variantes orthographiques pour les requêtes comportant au moins trois caractères. "`no_results`": demander des suggestions de variantes orthographiques si aucun résultat n'a été trouvé. "`no_spelling`": ne demandez pas de suggestions orthographiques. (par défaut)
`stemmed`	`boolean`	Requête sur des noms de radical et des alias Ne peut pas être utilisé avec `prefixed`.
`type`	`string`	Limiter aux sujets associés à cet ID de type Freebase
`with`	`string`	Règle de filtrage à mettre en correspondance.
`without`	`string`	Règle de filtrage à ne pas établir de correspondance.

Corps de la requête

Ne spécifiez pas de corps de requête pour cette méthode.

Réponse

Si la requête aboutit, la réponse est une structure 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
}