Rechercher

L'API Search permet d'accéder aux données Freebase à partir d'une requête en texte libre. Pour en savoir plus sur la création de requêtes de recherche détaillées, veuillez consulter Présentation de la recherche et le Guide de la recherche.

Requête

Requête HTTP

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

Paramètres

Tous les paramètres ci-dessous sont facultatifs, mais vous devez inclure query ou filter.

Nom du paramètre Valeur Description
Paramètres facultatifs
as_of_time string Valeur as_of_time MQL à utiliser avec les requêtes mql_output.
callback string Nom de la méthode JS pour les rappels JSONP.
cursor integer Le paramètre cursor, associé au paramètre limit, vous permet 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 Restreignez la recherche aux thèmes associés à cet ID de domaine Freebase.
encode string Encodage de la réponse. Vous pouvez utiliser ce paramètre pour activer l'encodage HTML.

Les valeurs acceptées sont les suivantes :
  • "html" : encode certains caractères de la réponse (tels que les balises et les esperluettes) à l'aide de l'encodage HTML.
  • "off" : aucune réponse n'est encodée. Vous ne devez pas imprimer les résultats directement sur une page Web sans d'abord échapper le contenu HTML. (par défaut)
exact boolean Requête portant uniquement sur le nom exact et les clés.
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 une langue 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 Guide de cuisine pour la recherche.
format string Format structurel de la réponse JSON.

Les valeurs acceptées sont les suivantes :
  • "entity" : informations de base sur les entités. (par défaut)
  • "ids" : liste ordonnée des ids Freebase.
  • "mids" : liste ordonnée des mids Freebase.
indent boolean Indique si les résultats JSON doivent être mis en retrait ou non.
lang string Code de la langue dans laquelle exécuter la requête. La valeur par défaut est "en".
limit integer Nombre maximal de résultats à renvoyer. Par défaut, 20 correspondances sont renvoyées par ordre décroissant de pertinence, si elles existent. Vous pouvez demander plus ou moins de correspondances en utilisant le paramètre limit avec une valeur différente. (Exemple)
mql_output string Requête MQL à exécuter sur les résultats pour extraire davantage de données. Une fois la requête exécutée, les ID des 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 Correspondance de préfixe avec les noms et les alias.
query string Terme de requête à rechercher.
scoring string Algorithme de scoring de pertinence à utiliser.

Les valeurs acceptées sont les suivantes :
  • "entity" : utilisez le classement des entités Freebase et de popularité. (par défaut)
  • "freebase" : utiliser le classement des entités Freebase.
  • "schema" : utilisez le classement des schémas pour les propriétés et les types.
spell string Demander des suggestions "Voulez-vous dire"

Les valeurs acceptées sont les suivantes :
  • "always" : demande des suggestions orthographiques pour toute requête d'au moins trois caractères.
  • "no_results" : demande des suggestions orthographiques si aucun résultat n'a été trouvé.
  • "no_spelling" : ne pas demander de suggestions orthographiques. (par défaut)
stemmed boolean Effectuez des requêtes sur les noms et alias avec radical. Ne peut pas être utilisé avec prefixed.
type string Limiter aux thèmes avec cet ID de type Freebase.
with string Règle de filtre à comparer.
without string Règle de filtre à ne pas faire correspondre.

Corps de la requête

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

Réponse

Si l'opération réussit, 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
}