Recherche d'achats

Dernière mise à jour July 20, 2026

Résultats de recherche d'achats (produits) au format JSON.

TEXT

GET /v1/shopping

Requiert une clé d'API valide, un abonnement actif et du crédit d'API disponible.

Paramètres de requête

Nom	Type	Obligatoire	Par défaut	Description
`q`	string	oui	—	La requête de recherche (un produit ou une catégorie).
`safe`	string	non	`on`	Niveau de recherche sécurisée : `off` ou `on`.
`gl`	string	non	(auto)	Code de région/pays à deux lettres (p. ex. `us`, `gb`) — affecte les prix/marchands.
`hl`	string	non	(auto)	Code de langue à deux lettres (p. ex. `en`, `es`).
`time`	string	non	`any`	Filtre de récence : `any`, `hour`, `day`, `week`, `month`, `year`.
`num`	integer	non	(défaut du fournisseur)	Nombre de résultats souhaité. Borné à 5–100 (hors plage → 20).

Réponse

JSON

{
  "query": "wireless headphones",
  "kind": "shopping",
  "results": [
    {
      "title": "Acme Wireless Headphones",
      "url": "https://shop.example.com/p/acme-wh",
      "description": "Over-ear, 40-hour battery…",
      "thumbnail": "https://shop.example.com/p/acme-wh/thumb.jpg",
      "price": "$129.99",
      "meta": "Example Store",
      "extra": null
    }
  ]
}

Champ	Type	Description
`query`	string	La requête qui a été exécutée.
`kind`	string	Toujours `shopping` pour cet endpoint.
`results[].title`	string	Titre du produit.
`results[].url`	string	URL de la page du produit.
`results[].description`	string \| null	Description du produit, lorsqu'elle est disponible.
`results[].thumbnail`	string \| null	URL de l'image du produit.
`results[].price`	string \| null	Prix formaté, lorsqu'il est disponible.
`results[].meta`	string \| null	Marchand / source.
`results[].extra`	string \| null	Pas habituellement utilisé pour les achats.

Exemples

cURL

curl -G "https://api.suede.io/v1/shopping" \
  -H "Authorization: Bearer $SUEDE_API_KEY" \
  --data-urlencode "q=wireless headphones" \
  --data-urlencode "gl=us"

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
    new("Bearer", Environment.GetEnvironmentVariable("SUEDE_API_KEY"));
var url = "https://api.suede.io/v1/shopping?q=" + Uri.EscapeDataString("wireless headphones") + "&gl=us";
Console.WriteLine(await http.GetStringAsync(url));

JavaScript

const params = new URLSearchParams({ q: "wireless headphones", gl: "us" });
const res = await fetch(`https://api.suede.io/v1/shopping?${params}`, {
  headers: { Authorization: `Bearer ${process.env.SUEDE_API_KEY}` },
});
const data = await res.json();
for (const r of data.results) console.log(`${r.title}: ${r.price} (${r.meta})`);