Informations de référence sur l’API Recherche d’actualités v7

Avertissement

API Recherche Bing sont déplacés de Cognitive Services à Recherche Bing services. À partir du 30 octobre 2020 , toute nouvelle instance de recherche Bing doit être approvisionnée en suivant le processus documenté ici. Les API Recherche Bing approvisionnées à l’aide de Cognitive Services seront prises en charge pendant les trois prochaines années ou jusqu’à la fin de votre Accord Entreprise, selon la première situation. Pour obtenir des instructions de migration, consultez Services recherche Bing.

L’API Recherche d’actualités vous permet d’envoyer une requête de recherche à Bing et de récupérer une liste d’Articles de News pertinents. Cette section fournit des détails techniques sur les paramètres de requête et les en-têtes que vous utilisez pour demander des articles d’actualité et les objets de réponse JSON qui les contiennent. Pour obtenir des exemples qui montrent comment effectuer des demandes, consultez recherche d’actualités sur le Web.

Pour plus d’informations sur les en-têtes que les demandes doivent inclure, consultez en-têtes de demande.

Pour plus d’informations sur les paramètres de requête que les demandes doivent inclure, consultez paramètres de requête.

Pour plus d’informations sur les objets JSON que la réponse peut inclure, consultez objets réponse.

Pour plus d’informations sur l’utilisation autorisée et l’affichage des résultats, consultez Recherche Bing l’utilisation de l' API et exigences d’affichage.

Notes

Étant donné que les paramètres et formats d’URL sont susceptibles de changer sans préavis, utilisez toutes les URL telles quelles. Vous ne devez pas créer de dépendances par rapport au format d’URL ou aux paramètres sauf indication contraire.

Points de terminaison

Pour demander des Articles de News, envoyez une demande d’accès à l’une des URL suivantes :

URL Description
https://api.cognitive.microsoft.com/bing/v7.0/news Retourne les premiers articles d’actualité par catégorie. Par exemple, vous pouvez demander les meilleurs articles sportifs ou Entertainment. Pour plus d’informations sur la spécification des catégories, consultez le paramètre de requête Category .
https://api.cognitive.microsoft.com/bing/v7.0/news/search Retourne des articles d’actualité basés sur la requête de recherche de l’utilisateur. Si la requête de recherche est vide, l’appel renvoie les articles en lien avec des actualités.
https://api.cognitive.microsoft.com/bing/v7.0/news/trendingtopics Retourne des rubriques d’actualité tendances qui sont en cours de tendance sur les réseaux sociaux.

Remarque : Disponible uniquement sur les marchés en-US et zh-CN.

Pour les abonnements à plusieurs services, vous devez inclure la région dans l’URL. Par exemple : westus.api.cognitive.microsoft.com. Consultez régions prises en charge.

La demande doit utiliser le protocole HTTPs ; HTTP n’est pas pris en charge.

Notes

La longueur maximale de l’URL est de 2 048 caractères. Pour que votre URL ne dépasse pas la limite, la longueur maximale de vos paramètres de requête doit être inférieure à 1 500 caractères. Si l’URL dépasse 2 048 caractères, le serveur retourne une erreur 404 (Introuvable).

headers

Voici les en-têtes possibles d’une demande et d’une réponse.

En-tête Description
Acceptation En-tête de demande facultatif.

Le type de média par défaut est application/json. Pour spécifier que la réponse utilise JSON-LD, donnez la valeur application/ld+json à l’en-tête Accept.
Accept-Language En-tête de demande facultatif.

Liste délimitée par des virgules des langues à utiliser pour les chaînes d’interface utilisateur. Elle est triée par ordre de préférence décroissant. Pour plus d’informations, notamment le format attendu, voir RFC2616.

Cet en-tête et le paramètre de requête setLang s’excluent mutuellement — ne spécifiez pas les deux.

Si vous définissez cet en-tête, vous devrez également spécifier le paramètre de requête cc. Pour déterminer pour quel marché les résultats devront être retournés, Bing utilise la première langue prise en charge qu’il trouve dans la liste et la combine avec la valeur du paramètre cc. Si la liste ne comporte pas de langue prise en charge, Bing recherche la langue et le marché les plus proches qui prennent en charge la demande, ou utilise un marché agrégé ou par défaut pour les résultats. Pour identifier le marché utilisé par Bing, voir l’en-tête BingAPIs-Market.

N’utilisez cet en-tête et le paramètre de requête cc que si vous spécifiez plusieurs langues. Sinon, utilisez les paramètres de requête mkt et setLang.

Une chaîne d’interface utilisateur est une chaîne utilisée comme étiquette dans une interface utilisateur. Les objets de réponse JSON en comportent quelques-unes. Les liens vers les propriétés Bing.com dans les objets de la réponse s’appliquent à la langue spécifiée.
BingAPIs-Market En-tête de réponse.

Marché utilisé par la demande. La forme est <languageCode>-<countryCode>. Par exemple, en-US.

Si vous spécifiez un marché qui n’est pas listé dans les codes de marché, cette valeur peut différer du marché que vous avez spécifié dans le paramètre de requête MKT . Il en va de même si vous spécifiez des valeurs pour CC et Accept-Language qui ne peuvent pas être rapprochées.
BingAPIs-TraceId En-tête de réponse.

ID de l’entrée du journal contenant les détails de la demande. Lorsqu’une erreur se produit, capturez cet ID. Si vous ne parvenez pas à identifier ou à résoudre le problème, précisez cet ID avec les autres informations envoyées à l’équipe de support.
Ocp-Apim-Subscription-Key En-tête de demande requis.

Clé d’abonnement reçue lors de l’inscription à ce service dans Cognitive Services.
Pragma En-tête de demande facultatif.

Par défaut, Bing retourne le contenu en cache, s’il est disponible. Pour empêcher le contenu mis en cache, affectez à l’en-tête pragma la valeur no-cache (par exemple, Pragma : no-cache).
Retry-After En-tête de réponse.

La réponse comprend cet en-tête si vous dépassez le nombre de requêtes autorisées par seconde (RPS) ou par mois (RPM). L’en-tête contient le nombre de secondes que vous devez attendre avant d’envoyer une autre demande.
User-Agent En-tête de demande facultatif.

Agent utilisateur à l’origine de la requête. Bing utilise l’agent utilisateur pour offrir une expérience optimisée aux utilisateurs mobiles. Nous vous conseillons de toujours indiquer cet en-tête, bien qu’il soit facultatif.

L’agent utilisateur doit correspondre à la chaîne envoyée par n’importe quel navigateur couramment utilisé. Pour plus d’informations sur les agents utilisateurs, voir RFC 2616.

Voici quelques exemples de chaînes de l’agent utilisateur.
  • Windows Phone—Mozilla/5.0 (compatible ; MSIE 10.0 ; Windows Phone 8.0 ; Trident/6.0 ; IEMobile/10.0 ; ARM ; Touch ; NOKIA ; Lumia 822)

  • Android—Mozilla/5.0 (Linux ; U ; Android 2.3.5 ; en-us ; SCH-I500 Build/GINGERBREAD) AppleWebKit/533.1 (KHTML ; comme Gecko) Version/4.0 Mobile Safari/533.1

  • iPhone—Mozilla/5.0 (iPhone ; CPU iPhone OS 6_1 comme Mac OS X) AppleWebKit/536.26 (KHTML ; comme Gecko) Mobile/10B142 iPhone4;1 BingWeb/3.03.1428.20120423

  • PC—Mozilla/5.0 (Windows NT 6.3 ; WOW64 ; Trident/7.0 ; Touch ; rv:11.0) comme Gecko

  • iPad—Mozilla/5.0 (iPad ; CPU OS 7_0 comme Mac OS X) AppleWebKit/537.51.1 (KHTML, comme Gecko) Version/7.0 Mobile/11A465 Safari/9537.53
X-MSEdge-ClientID En-tête de demande et de réponse facultatif.

Bing utilise cet en-tête pour garantir aux utilisateurs un comportement cohérent d’un appel d’API Bing à l’autre. Bing propose souvent de nouvelles fonctionnalités et améliorations, et se sert de l’ID client comme d’une clé pour attribuer le trafic aux différentes versions d’évaluation. Si vous n’assignez pas le même ID client à un utilisateur d’une demande à l’autre, Bing est susceptible d’affecter cet utilisateur à plusieurs versions d’évaluation en conflit, ce qui risque de nuire à l’expérience utilisateur. Par exemple, si la deuxième demande comporte une attribution de version d’évaluation différente de la première, l’expérience se révélera peut-être inattendue. En outre, Bing peut utiliser l’ID client pour adapter les résultats Web à l’historique de recherche de cet ID client, ce qui offre une expérience plus riche pour l’utilisateur.

Bing utilise également cet en-tête pour aider à améliorer le classement des résultats en analysant l’activité générée par un ID client. L’amélioration de la pertinence permet d’obtenir des résultats de meilleure qualité de la part des API Bing et, en retour, des taux de clic plus élevés pour le consommateur des API.

IMPORTANT : Il est vivement recommandé d’indiquer cet en-tête, bien qu’il soit facultatif. Grâce à la persistance de l’ID client dans plusieurs demandes pour une même combinaison appareil/utilisateur final, (1) le consommateur des API bénéficie d’une expérience utilisateur cohérente et (2) le taux de clic est plus élevé du fait des résultats de meilleure qualité provenant des API Bing.

Voici les règles d’utilisation de base qui s’appliquent à cet en-tête.
  • Chaque utilisateur de votre application sur l’appareil doit avoir un ID client unique, généré par Bing.

    Si vous n’insérez pas cet en-tête dans la demande, Bing génère un ID et le retourne dans l’en-tête de réponse X-MSEdge-ClientID. La première fois que l’utilisateur utilise votre application sur cet appareil est la seule fois où vous ne devez PAS inclure cet en-tête dans la demande.

  • ATTENTION : Vérifiez que cet ID client ne peut pas être associé à des informations authentifiables sur le compte d’utilisateur.

  • Utilisez l’ID client pour chaque requête d’API Bing qu’effectue votre application pour cet utilisateur sur l’appareil.

  • Conservez l’ID client. Pour conserver l’identifiant dans une application de navigateur, utilisez un cookie HTTP persistant qui garantit l’utilisation de cet identifiant dans toutes les sessions. N’utilisez pas de cookie de session. Dans le cas d’autres applications, comme des applications mobiles, utilisez le stockage persistant de l’appareil pour conserver cet identifiant.

    La prochaine fois que l’utilisateur utilisera votre application sur cet appareil, vous récupérerez l’ID client que vous aurez conservé.

REMARQUE : Les réponses de Bing ne comportent pas forcément cet en-tête. Si elles l’incluent, capturez l’ID client et utilisez-le pour toutes les demandes Bing suivantes concernant l’utilisateur sur cet appareil.

REMARQUE : Si vous insérez l’en-tête X-MSEdge-ClientID, n’incluez pas les cookies dans la requête.
X-MSEdge-ClientIP En-tête de demande facultatif.

Adresse IPv4 ou IPv6 de l’appareil client. L’adresse IP est utilisée pour découvrir l’emplacement de l’utilisateur. Bing utilise les informations de localisation pour déterminer le comportement de recherche approprié.

REMARQUE : Nous vous conseillons de toujours indiquer cet en-tête et l’en-tête X-Search-Location, bien qu’ils soient facultatifs.

N’obfusquez pas l’adresse (par exemple, en remplaçant le dernier octet par 0). Cela aurait pour effet d’éloigner la localisation de l’emplacement réel de l’appareil, ce qui pourrait conduire Bing à retourner des résultats erronés.
X-Search-Location En-tête de demande facultatif.

Liste délimitée par des points-virgules de paires clé/valeur qui décrivent la situation géographique du client. Bing utilise les informations de localisation pour déterminer le comportement de recherche approprié et retourner le contenu local pertinent. Spécifiez la paire clé/valeur sous la forme <key>:<value>. Voici les clés permettant de spécifier l’emplacement de l’utilisateur.

  • lat — Obligatoire. Latitude de la localisation du client, en degrés. Elle doit être supérieure ou égale à -90,0 et inférieure ou égale à +90,0. Les valeurs négatives indiquent les latitudes sud et les valeurs positives les latitudes nord.

  • long — Obligatoire. Longitude de la localisation du client, en degrés. Elle doit être supérieure ou égale à -180,0 et inférieure ou égale à +180,0. Les valeurs négatives indiquent les longitudes occidentales et les valeurs positives les longitudes orientales.

  • re — Obligatoire. Rayon, en mètres, qui spécifie la précision horizontale des coordonnées. Transmettez la valeur retournée par le service de localisation de l’appareil. Voici quelques valeurs courantes : 22 m pour le GPS/Wi-Fi, 380 m pour la triangulation des tours cellulaires et 18 000 m pour la recherche IP inversée.

  • ts — Facultatif. Horodatage UTC UNIX correspondant au moment où le client était à cette position. (L’horodatage UNIX est le nombre de secondes écoulées depuis le 1er janvier 1970.)

  • head — Facultatif. Direction relative du client en déplacement. Spécifiez-la en degrés, entre 0 et 360, dans le sens horaire par rapport au nord géographique. N’indiquez cette clé que si la clé sp est différente de zéro.

  • sp — Facultatif. Vitesse horizontale, en mètres par seconde, à laquelle se déplace l’appareil client.

  • alt — Facultatif. Altitude de l’appareil client, en mètres.

  • are — Facultatif. Rayon, en mètres, qui spécifie la précision verticale des coordonnées. N’indiquez cette clé que si vous spécifiez la clé alt.

  • DISP — facultatif. Emplacement géographique de l’utilisateur sous la forme, DISP : <City, State>. Par exemple, DISP : Seattle, Washington. Il s’agit de la version texte d’affichage de l’emplacement de l’utilisateur que vous avez spécifiée à l’aide des clés lat/long. Si cette valeur est en conflit avec les coordonnées lat/long, Bing utilise la valeur DISP comme emplacement de l’utilisateur.

Remarque : Bing ignore cet en-tête si la requête comprend un emplacement. Par exemple, si cet en-tête reflète l’emplacement de l’utilisateur en tant que San Francisco, mais que la requête est restaurant Seattle , Bing retourne des restaurants situés à Seattle, Washington.

REMARQUE : Bien que la plupart des clés soient facultatives, plus vous fournissez d’informations, plus les résultats de localisation sont précis.

REMARQUE : Nous vous conseillons de toujours indiquer la situation géographique de l’utilisateur (qui est facultative). C’est particulièrement important si l’adresse IP du client ne reflète pas exactement l’emplacement physique de l’utilisateur (par exemple, si le client utilise un VPN). Pour obtenir des résultats optimaux, vous devez inclure cet en-tête et l’en-tête X-Search-ipclient, mais au minimum, vous devez inclure cet en-tête.

Notes

N’oubliez pas que les conditions d’utilisation imposent le respect de toutes les lois en vigueur, y compris en ce qui concerne l’utilisation de ces en-têtes. Par exemple, dans certaines juridictions, comme en Europe, il faut obtenir le consentement de l’utilisateur pour pouvoir placer certains dispositifs de suivi sur les appareils des utilisateurs.

Paramètres de requête

Voici les paramètres de requête que la demande peut inclure. La colonne Obligatoire indique si vous devez absolument spécifier le paramètre. Vous devez encoder les valeurs des paramètres de requête dans une URL.

Name Valeur Type Obligatoire
cc Code à 2 caractères du pays d'où proviennent les résultats. Pour obtenir la liste des valeurs possibles, consultez la rubrique codes de marché.

Si vous définissez ce paramètre, vous devez également spécifier l’en-tête Accept-Language. Bing utilise la première langue prise en charge trouvée dans les langues spécifiées et l’associe à l’indicatif du pays pour déterminer le marché pour lequel retourner les résultats. Si la liste des langues n’inclut de langue prise en charge, Bing recherche la langue et le marché les plus proches qui prennent en charge la requête. Ou, Bing peut utiliser un marché agrégé ou par défaut pour les résultats.

Utilisez ce paramètre de requête et l' Accept-Language en-tête uniquement si vous spécifiez plusieurs langues. Dans le cas contraire, vous devez utiliser les mkt setLang paramètres de requête et.

Ce paramètre et le paramètre de requête mkt s’excluent mutuellement — ne spécifiez pas les deux.
String Non
catégorie Catégorie d’articles à retourner. Par exemple, articles sportifs ou Articles de divertissement. Pour obtenir la liste des catégories possibles, consultez catégories d’actualités par marché.

Utilisez ce paramètre uniquement avec les demandes de catégorie Actualités (voir le point de terminaison/News).

Si vous ne spécifiez pas ce paramètre, la réponse comprend les deux éléments suivants :
  • Articles en gros titres publiés au cours des dernières 24 heures à partir de n’importe quelle catégorie, mais certains articles peuvent être plus anciens.

    Si l’article est un titre, le champ en- tête de l’article a la valeur true . Par défaut, la réponse comprend jusqu’à 12 Articles et clusters. Pour spécifier le nombre d’articles en titres à retourner, définissez le headlineCount paramètre de requête.

  • Articles de chaque catégorie parent (jusqu’à quatre articles et clusters de chaque catégorie).

Si vous ne spécifiez pas headlineCount et que le marché prend en charge huit catégories, la réponse comprend jusqu’à 44 Articles et clusters (12 Articles et clusters de 12 titres, plus les clusters et articles spécifiques à la catégorie 32). Comme un cluster contient plus d’un article, le nombre d’articles dans cet exemple, 44, peut être plus. Par exemple, la réponse peut inclure 11 Articles en gros et un cluster, qui contient quatre articles associés pour un total de 15 Articles en gros.
String Non
count Nombre d’Articles de News à retourner dans la réponse. Le nombre réel renvoyé peut être inférieur à ce que vous avez demandé. La valeur par défaut est 10 et la valeur maximale est 100.

Pour les rubriques tendance, la valeur par défaut est toutes les actualités tendances (environ 55 Articles).

Vous pouvez utiliser ce paramètre avec le offset paramètre pour paginer les résultats. Par exemple, si votre interface utilisateur affiche 20 Articles par page, définissez count sur 20 et offset sur 0 pour obtenir la première page de résultats. Pour chaque page suivante, incrément de offset 20 (par exemple, 0, 20, 40). Il est possible que plusieurs pages incluent un chevauchement des résultats.

Remarque : Les clusters sont comptés comme un seul élément. Par exemple, si vous définissez le nombre sur 10, la réponse peut inclure 9 Articles et 1 cluster, mais le cluster peut contenir 5 Articles.

Remarque : Si vous demandez des catégories d’actualités, spécifiez ce paramètre uniquement si vous spécifiez le paramètre Category. Si vous ne spécifiez pas le paramètre Category, Bing ignore ce paramètre.
UnsignedShort No
actualisation Filtrer les Articles de News en suivant les valeurs d’âge suivantes :
  • Le jour — retourne les Articles de News découverts par Bing au cours des dernières 24 heures
  • —La semaine renvoie les Articles de News découverts par Bing au cours des 7 derniers jours
  • Le mois — retourne les Articles de News découverts par Bing au cours des 30 derniers jours
String Non
headlineCount Nombre d’articles et de clusters en gros à retourner. La valeur par défaut est 12.

Spécifiez ce paramètre uniquement si vous ne spécifiez pas le paramètre Category. Si vous spécifiez le paramètre Category, Bing ignore ce paramètre.

Utilisez ce paramètre uniquement avec les demandes de catégorie Actualités.
UnsignedShort Non
mkt Marché d’où proviennent les résultats. En général, mkt est le pays où l’utilisateur effectue la demande. Toutefois, il peut s’agir d’un pays différent si l’utilisateur ne se trouve pas dans un pays où Bing fournit des résultats. Le marché doit se présenter sous la forme <language code> - <country code> . Par exemple, en-US. La chaîne ne respecte pas la casse. Pour obtenir la liste des valeurs de marché possibles, consultez la rubrique codes de marché.

Remarque : S’il est connu, il est recommandé de toujours spécifier le marché. Le fait d’indiquer le marché aide Bing à router la requête et à renvoyer une réponse appropriée et optimale. Si vous spécifiez un marché qui n’est pas listé dans les codes de marché, Bing utilise le code de marché le mieux adapté en fonction d’un mappage interne susceptible d’être modifié.

Ce paramètre et le paramètre de requête cc s’excluent mutuellement — ne spécifiez pas les deux.
String Non
offset Décalage de base zéro qui indique le nombre d’Articles de News à ignorer avant de retourner des articles. La valeur par défaut est 0. Le décalage doit être inférieur à (totalEstimatedMatches - count ).

Utilisez ce paramètre avec le count paramètre pour paginer les résultats. Par exemple, si votre interface utilisateur affiche 20 Articles par page, définissez count sur 20 et offset sur 0 pour obtenir la première page de résultats. Pour chaque page suivante, incrément de offset 20 (par exemple, 0, 20, 40). Il est possible que plusieurs pages incluent un chevauchement des résultats.

Remarque : Les clusters sont comptés comme un seul élément. Par exemple, si vous définissez le nombre sur 10, la réponse peut inclure 9 Articles et 1 cluster, mais le cluster peut contenir 5 Articles.

Remarque : Si vous demandez des catégories de News, spécifiez ce paramètre uniquement si vous spécifiez le paramètre Category. Si vous ne spécifiez pas le paramètre Category, Bing ignore ce paramètre.
Court non signé No
originalImg Valeur booléenne qui détermine si le de l’image contentUrl contient une URL qui pointe vers une miniature de l’image de l’article d’origine ou de l’image elle-même.

Si l’article inclut une image et que ce paramètre a la valeur true , la propriété de l’image contentUrl contient une URL que vous pouvez utiliser pour télécharger l’image d’origine à partir du site Web de l’éditeur. Sinon, si ce paramètre a la valeur false , les URL et de l’image contentUrl thumbnailUrl pointent toutes les deux vers la même image miniature.

La valeur par défaut est false.

Utilisez ce paramètre uniquement avec l’API Recherche d’actualités. Ne spécifiez pas ce paramètre lors de l’appel de l’API Recherche Web. Les rubriques tendance ignorent ce paramètre.
Boolean Non
q Terme de requête de recherche de l’utilisateur. Si le terme est vide (par exemple, q =), la réponse comprend les premiers articles d’actualité.

Le terme chaîne peut contenir des opérateurs avancés Bing. Par exemple, pour limiter les nouvelles à un domaine spécifique, utilisez l’opérateur site : .

Si vous obtenez des Articles de News par catégorie, n’incluez pas ce paramètre. Les rubriques tendance ignorent ce paramètre.
String Oui
safeSearch Filtrez les Articles de News pour le contenu pour adultes. Les valeurs de filtre possibles sont les suivantes.
  • OFF — retourne des Articles de News avec du texte, des images ou des vidéos pour adultes.

  • La — fonction modérée retourne des Articles de News avec du texte pour adultes, mais pas des images ou des vidéos adultes.

  • Strict — ne retourne pas d’Articles de News avec du texte, des images ou des vidéos pour adultes.

La valeur par défaut est Modéré.

REMARQUE : Si la demande provient d’un marché où la stratégie de Bing en matière de contenu pour adultes exige que safeSearch ait la valeur Strict, Bing ignore la valeur safeSearch et utilise Strict.
String Non
setLang Langue à utiliser pour les chaînes de l’interface utilisateur. Vous pouvez spécifier la langue à l’aide d’un code à 2 ou 4 lettres. Il est préférable d’utiliser des codes à 4 lettres.

Pour obtenir la liste des codes de langue pris en charge, consultez langues prises en charge par Bing.

Bing charge les chaînes localisées si setlang contient un code de culture neutre à 2 lettres valide ( fr ) ou un code de culture spécifique à 4 lettres valide ( fr-ca ). Par exemple, pour fr-ca , Bing charge les chaînes de code de culture neutres fr .

Si setlang n’est pas valide (par exemple, zh ) ou que Bing ne prend pas en charge la langue (par exemple, AF , AF-na ) en , Bing prend par défaut la valeur en (anglais).

Pour spécifier le code à deux lettres, définissez ce paramètre sur un code de langue ISO 639-1.

Pour spécifier le code à 4 lettres, utilisez le <pays/région> où est un code ISO 639-1 langue (culture neutre) et <pays/région> est un code ISO 3166 pays/région (culture spécifique). Par exemple, utilisez en-US pour États-Unis anglais.

Nous vous conseillons de toujours indiquer la langue, bien qu’elle soit facultative. En général, on définit setLang sur la langue spécifiée par mkt, sauf si l’utilisateur souhaite que les chaînes de l’interface utilisateur soient affichées dans une autre langue.

Ce paramètre et l’en-tête Accept-Language s’excluent mutuellement : ne spécifiez pas les deux.

Une chaîne d’interface utilisateur est une chaîne utilisée comme étiquette dans une interface utilisateur. Les objets de réponse JSON en comportent quelques-unes. En outre, les liens vers les propriétés Bing.com dans les objets de la réponse s’appliquent à la langue spécifiée.
String Non
since L’heure d’époque UNIX (horodatage UNIX) que Bing utilise pour sélectionner les rubriques tendance. Bing retourne les sujets de tendance qu’il a découverts à la date et à l’heure spécifiées, et non la date à laquelle la rubrique a été publiée.

Pour utiliser ce paramètre, spécifiez également le sortBy paramètre.
Integer Non
sortBy Ordre dans lequel les rubriques de tendance doivent être retournées. Voici les valeurs possibles. Elles ne sont pas sensibles à la casse.
  • —La date retourne les rubriques de tendance triées par date du plus récent au plus ancien

Si vous ne spécifiez pas ce paramètre, il n’existe aucun classement spécifique. Toutefois, les fonctionnalités d’actualisation, de catégorie, d’engagement utilisateur global et de personnalisation des rubriques sont prises en compte.
String Non
textDecorations Valeur booléenne qui détermine si les chaînes d’affichage doivent contenir des marqueurs de décoration, tels que des caractères de mise en surbrillance d’atteinte. Si la valeur est true , les chaînes peuvent inclure des marqueurs. La valeur par défaut est false .

Pour spécifier s’il faut utiliser des caractères Unicode ou des balises HTML comme marqueurs, consultez le paramètre de requête FormatTexte .

Pour plus d’informations sur la mise en surbrillance des correspondances, consultez mise en surbrillance.
Boolean Non
textFormat Type des marqueurs à utiliser pour les décorations de texte (consultez le textDecorations paramètre de requête).

Les valeurs possibles sont les suivantes.
  • RAW — Utilisez des caractères Unicode pour marquer le contenu qui nécessite une mise en forme spéciale. Les caractères Unicode se trouvent dans la plage E000 à E019. Par exemple, Bing utilise E000 et E001 pour marquer le début et la fin des termes de requête pour la mise en surbrillance des correspondances.

  • HTML — Utilisez des balises HTML pour marquer le contenu qui nécessite une mise en forme spéciale. Par exemple, utilisez des <b> balises pour mettre en surbrillance les termes de requête dans les chaînes d’affichage.

La valeur par défaut est RAW.

Pour obtenir la liste des marqueurs, consultez mise en surbrillance des correspondances.

Pour les chaînes d’affichage qui contiennent des caractères HTML pouvant être échappés, tels que <, > et &, si textFormat a la valeur html, Bing échappe les caractères selon le cas (par exemple, < est placé dans une séquence d’échappement vers & lt ;).

Pour plus d’informations sur le traitement des chaînes avec des caractères Unicode incorporés, consultez mise en surbrillance des correspondances.
String Non

Objets réponse

Notes

Pour se conformer à la nouvelle directive européenne sur les droits d’auteur en France, les API Bing Web, News, Video, image et toutes les API de recherche personnalisées doivent omettre du contenu de certaines sources d’actualité de l’Union européenne pour les utilisateurs français. Le contenu supprimé peut inclure des images miniatures et des vidéos, des aperçus vidéo et des extraits de code qui accompagnent les résultats de recherche de ces sources. Par conséquent, les API Bing peuvent servir moins de résultats avec des images miniatures et des vidéos, des aperçus vidéo et des extraits de code pour les utilisateurs français.

Voici les objets JSON que la réponse peut inclure. Si la demande est réussie, l’objet de niveau supérieur dans la réponse est l’objet d' actualité si le point de terminaison est/News/Search ou/News, et TrendingTopicAnswer si le point de terminaison est/News/trendingtopics. Si la demande échoue, l’objet de niveau supérieur est l’objet ErrorResponse.

Object Description
Error Définit une erreur qui s’est produite.
ErrorResponse Définit l’objet de niveau supérieur que la réponse contient lorsque la requête échoue.
Image Définit une miniature d’une image relative aux actualités.
MediaSize Définit la taille du contenu multimédia.
Actualités Définit l’objet de niveau supérieur que la réponse contient lorsque la demande d’informations est réussie.
NewsArticle Définit un article d’actualité.
Organisation Définit le fournisseur qui a exécuté l’article.
Requête Définit la chaîne de requête de recherche.
RelatedTopic Définit une liste d’Articles de News associés à la requête de recherche.
Vidéo miniature Définit un lien vers l’image associée.
Rubrique Définit une rubrique de nouvelles tendances.
TrendingTopics Définit l’objet de niveau supérieur que la réponse contient lorsque la demande de rubriques de tendance est réussie.
Vidéo Définit une vidéo qui est associée à l’article d’actualité.

Error

Définit l’erreur qui s’est produite.

Élément Description Type
code Code d’erreur identifiant la catégorie de l’erreur. Pour connaître la liste des codes possibles, voir Codes d’erreur. String
message Description de l’erreur. String
moreDetails Description de l’erreur comportant des informations supplémentaires. String
parameter Paramètre de requête de la demande ayant provoqué l’erreur. String
subCode Code identifiant l’erreur. Par exemple, si code est InvalidRequest, subCode peut être ParameterInvalid ou ParameterInvalidValue. String
value Valeur du paramètre de requête qui n’était pas valide. String

ErrorResponse

Objet de niveau supérieur figurant dans la réponse en cas d’échec de la demande.

Nom Valeur Type
_type Indicateur de type. String
errors Liste des erreurs qui décrivent les raisons pour lesquelles la demande a échoué. Error[]

Image

Définit une miniature d’une image relative aux actualités.

Nom Valeur Type
provider Liste de propriétaires de l’image. Organisation
thumbnail Lien vers une miniature de l’image. Vidéo miniature
url URL de l’image. String

MediaSize

Définit la taille du contenu multimédia.

Nom Valeur Type
Taille Hauteur du contenu multimédia, en pixels. Integer
width Largeur du contenu multimédia, en pixels. Integer

Actualités

Définit l’objet de niveau supérieur que la réponse contient lorsque la demande d’informations est réussie.

Si le service suspecte une attaque par déni de service, la requête réussit (le code d’état HTTP est 200 OK), mais le corps de la réponse est vide.

Nom Valeur Type
_type Indicateur de type. String
id ID qui identifie de façon unique la réponse aux actualités.

Pour plus d’informations sur l’utilisation de ce champ, consultez utilisation de classement pour afficher les résultats dans le Guide de l’API recherche Web.
String
readLink URL qui retourne cette réponse. Pour utiliser l’URL, ajoutez les paramètres de requête appropriés et incluez l’en-tête OCP-APIM-subscription-Key .

L’API Recherche Web comprend ce champ. En règle générale, vous utilisez l’URL si vous souhaitez interroger directement l’API Recherche d’actualités.
String
relatedTopics Liste des Articles relatifs au terme recherché. RelatedTopic[]
Tris Liste des options de tri des articles d’actualité. Par exemple, triez par pertinence (par défaut) ou par date. Pour déterminer l’ordre de tri utilisé par la requête, consultez le isSelected champ. SortValue[]
totalEstimatedMatches Nombre estimé d’articles d’actualité relatifs à la requête. Utilisez ce nombre avec les paramètres de requête Count et offset pour paginer les résultats.

Seule l’API Recherche d’actualités comprend ce champ (l’API Recherche Web ne le fait pas).
Long
value Liste des articles d’actualité relatifs au terme de requête.

S’il n’y a aucun résultat à retourner pour la demande, le tableau est vide.
NewsArticle[]

NewsArticle

Définit un article d’actualité.

Nom Valeur Type
catégorie Catégorie d’actualités à laquelle l’article appartient. Par exemple, sports. Si la catégorie Actualités ne peut pas être déterminée, l’article ne contient pas ce champ.

Pour obtenir la liste des catégories possibles, consultez catégories d’actualités par marché.

Si votre demande spécifie la catégorie Sports-Tennis, la category propriété peut contenir Sports-Tennis ou sports.
String
clusteredArticles Liste d’articles connexes. NewsArticle[]
contractualRules Liste des règles que vous devez respecter si vous affichez l’article. Par exemple, les règles peuvent déterminer si vous devez fournir une attribution.

Les règles contractuelles suivantes peuvent s’appliquer.

Si l’article fournit des règles contractuelles, vous devez les respecter.

Remarque : Seuls les articles retournés par l' API recherche Web contiennent des règles contractuelles. Les articles retournés par les points de terminaison de News n’incluent pas les règles contractuelles.
Object[]
datePublished Date et heure de détection de l’article par Bing. La date est au format AAAA-MM-JJThh : MM : SS. String
description Brève description de l’article d’actualité. String
titre Valeur booléenne qui indique si l’article d’actualité est un titre. Si la valeur est true , l’article est un titre.

Remarque : L’article comprend ce champ uniquement pour les demandes de catégories d’actualités qui ne spécifient pas le paramètre de requête Category .
Boolean
id ID qui identifie de façon unique cet article dans la liste des articles.

Pour plus d’informations sur l’utilisation de ce champ, consultez utilisation de classement pour afficher les résultats dans le Guide de l’API recherche Web.
String
image Image associée au nouvel article.

L' Image objet dans ce contexte contient uniquement le thumbnail champ.
Image
Mentions Liste des entités (lieux ou personnes) mentionnées dans l’article. Élément[]
name Nom de l’article.

Utilisez ce nom avec l’URL pour créer un lien hypertexte qui, lorsque vous cliquez dessus, amène l’utilisateur à l’article d’actualité.
String
moteur Liste des fournisseurs qui ont exécuté l’article. Organisation[]
URL URL de l’article d’actualité.

Utilisez cette URL avec name pour créer un lien hypertexte qui, lorsque vous cliquez dessus, amène l’utilisateur à l’article d’actualité.
String
vidéosurveillance Vidéo associée à l’article d’actualité. Vidéo

Organisation

Définit le fournisseur qui a exécuté l’article.

Nom Valeur Type
_type Indicateur de type. String
name Nom du fournisseur qui a exécuté l’article. String

Requête

Définit la chaîne de requête de recherche.

Nom Valeur Type
texte Chaîne de requête qui retourne la rubrique tendance. String

RelatedTopic

Définit une liste d’Articles de News associés à la requête de recherche.

Nom Valeur Type
relatedNews Liste d’articles connexes. NewsArticle
name Terme de requête associé qui a retourné les Articles de News associés. String
webSearchUrl URL qui dirige l’utilisateur vers les résultats de recherche Bing pour la requête associée. String

SortValue

Définit un ordre de tri à utiliser pour la requête.

Nom Valeur Type
id Identificateur qui identifie l’ordre de tri des articles. Les valeurs possibles sont les suivantes.
  • —Tri par date
  • pertinence — Trier par pertinence
String
isSelected Valeur booléenne qui détermine si la réponse utilise cet ordre de tri. Si la valeur est true , la réponse utilise cet ordre de tri. Boolean
name Nom complet de l’ordre de tri. String
url URL que vous pouvez utiliser pour effectuer la même demande à l’aide de cet ordre de tri. String

TextAttribution

Définit une règle contractuelle pour l’attribution du texte brut.

Nom Valeur Type
_type Indicateur de type, défini sur TextAttribution. String
texte Texte d’attribution.

L’attribution de texte s’applique à l’article d’actualité dans son ensemble et doit être affichée immédiatement après la présentation de l’article. Si plusieurs règles d’attribution du texte ou du lien ne spécifient pas de cible, concaténez-les et affichez-les avec une étiquette « Données provenant de : ».
String

Thing

Définit une entité que l’article mentionne.

Nom Valeur Type
name Nom de l’entité à laquelle l’article fait mention. String

Thumbnail

Définit un lien vers l’image associée.

Nom Valeur Type
contentUrl URL de l’image. String
celle Hauteur de l’image, en pixels. Court non signé
Largeur Largeur de l’image, en pixels. Court non signé

Rubrique

Définit une rubrique de nouvelles tendances.

Nom Valeur Type
image Lien vers une image associée.

L' Image objet dans ce contexte contient uniquement le url provider champ et. Le provider champ est un tableau d’objets d' organisation qui identifient les fournisseurs d’images.
Image
isBreakingNews Valeur booléenne qui indique si la rubrique est considérée comme des dernières nouvelles. Si la rubrique est considérée comme des dernières nouvelles, la valeur est true . Boolean
name Titre de la rubrique tendance. String
newsSearchUrl URL des résultats de recherche Bing News pour le terme de requête de recherche (voir le query champ). String
query Terme de requête de recherche qui retourne cette rubrique de tendance. Requête
webSearchUrl URL des résultats de recherche Bing pour le terme de requête de recherche (voir le query champ). String

TrendingTopics

Définit l’objet de niveau supérieur que la réponse contient lorsque la demande de rubriques de tendance est réussie.

Nom Valeur Type
value Liste des rubriques d’actualité relatives aux tendances sur Bing.

S’il n’y a aucun résultat à retourner pour la demande, le tableau est vide.
Rubrique[]

Vidéo

Définit une vidéo qui est associée à l’article d’actualité.

Notes

Étant donné que le format et les paramètres de l’URL sont susceptibles d’être modifiés sans préavis, utilisez toutes les URL telles quelles. Vous ne devez pas prendre de dépendances sur le format ou les paramètres de l’URL.

Nom Valeur Type
allowHttpsEmbed Valeur booléenne qui détermine si vous pouvez incorporer la vidéo (voir le embedHtml champ) sur les pages qui utilisent le protocole HTTPS. Boolean
embedHtml Iframe qui vous permet d’incorporer et d’exécuter la vidéo dans votre page Web. String
motionThumbnailUrl URL vers une miniature animée qui affiche un aperçu de la vidéo. En règle générale, vous utilisez cette URL pour lire un aperçu de la vidéo lorsque la souris de l’utilisateur se trouve sur la miniature de la vidéo sur la page des résultats. String
name Nom de la vidéo. String
fer Largeur et hauteur de l’image miniature ou de la miniature de mouvement. MediaSize
thumbnailUrl URL d’une image miniature de la vidéo. Pour plus d’informations sur le redimensionnement de l’image, consultez redimensionner et rogner des images miniatures. String

Catégories d’actualités par marché

Vous trouverez ci-dessous les catégories de News possibles pour lesquelles vous pouvez définir le paramètre de requête Category . Vous pouvez définir category une catégorie parente telle que Entertainment ou l’une de ses sous-catégories, par exemple Entertainment_MovieAndTV. Si vous définissez category sur une catégorie parente, elle contient des articles d’une ou plusieurs de ses sous-catégories. Si vous définissez category sur une sous-catégorie, il n’y a que des articles provenant de la sous-catégorie.

Marché Catégories prises en charge
Australie (en-au)
  • Australie
  • Entreprises
  • Divertissement
  • Politique
  • Sports
  • World (Monde)
Canada (en-Californie)
  • Entreprises
  • Canada
  • Divertissement
  • Va
  • Politique
  • ScienceAndTechnology
  • Sports
  • World (Monde)
Chine (zh-CN)
  • Auto
  • Entreprises
  • Chine
  • Education
  • Divertissement
  • Armée
  • RealEstate
  • ScienceAndTechnology
  • Préconis
  • Sports
  • World (Monde)
Inde (en-IN)
  • Entreprises
  • Divertissement
  • Inde
  • Va
  • Politique
  • ScienceAndTechnology
  • Sports
  • World (Monde)
Japon (ja-JP)
  • Entreprises
  • Divertissement
  • Japon
  • Va
  • Politique
  • ScienceAndTechnology
  • Sports
  • World (Monde)
Royaume-Uni (en-GB)
  • Entreprises
  • Divertissement
  • Santé
  • Politique
  • ScienceAndTechnology
  • Sports
  • Royaume-Uni
  • World (Monde)
États-Unis (en-US)
  • Entreprises
  • Divertissement
    • Entertainment_MovieAndTV
    • Entertainment_Music
  • Santé
  • Politique
  • Produits
  • ScienceAndTechnology
    • Technologie
    • Sciences
  • Sports
    • Sports_Golf
    • Sports_MLB
    • Sports_NBA
    • Sports_NFL
    • Sports_NHL
    • Sports_Soccer
    • Sports_Tennis
    • Sports_CFB
    • Sports_CBB
  • US
    • US_Northeast
    • US_South
    • US_Midwest
    • US_West
  • World (Monde)
  • World_Africa
  • World_Americas
  • World_Asia
  • World_Europe
  • World_MiddleEast

Codes d’erreur

Voici les codes d’état HTTP qu’une demande peut retourner.

Code d’état Description
200 Réussite.
400 L’un des paramètres de requête est manquant ou non valide.
401 La clé d’abonnement est manquante ou non valide.
403 L’utilisateur est authentifié (par exemple, il a utilisé une clé d’abonnement valide), mais il n’est pas autorisé à accéder à la ressource demandée.

Bing peut également retourner cet état si l’appelant a dépassé son quota mensuel de requêtes.
410 La demande a utilisé le protocole HTTP au lieu du protocole HTTPS. HTTPS est le seul protocole pris en charge.
429 L’appelant a dépassé son quota de requêtes par seconde.
500 Événement serveur inattendu.

Si la demande échoue, la réponse comporte un objet ErrorResponse qui contient une liste d’objets Error décrivant l’origine de l’erreur. Si l’erreur est liée à un paramètre, le champ parameter identifie celui qui pose problème. De même, si l’erreur est liée à une valeur de paramètre, le champ value identifie la valeur non valide.

{
  "_type": "ErrorResponse", 
  "errors": [
    {
      "code": "InvalidRequest", 
      "subCode": "ParameterMissing", 
      "message": "Required parameter is missing.", 
      "parameter": "q" 
    }
  ]
}

{
  "_type": "ErrorResponse", 
  "errors": [
    {
      "code": "InvalidAuthorization", 
      "subCode": "AuthorizationMissing", 
      "message": "Authorization is required.", 
      "moreDetails": "Subscription key is not recognized."
    }
  ]
}

Voici les valeurs possibles de code d’erreur et de sous-code d’erreur.

Code SubCode Description
ServerError UnexpectedError
ResourceError
NotImplemented
Le code d’état HTTP est 500.
InvalidRequest ParameterMissing
ParameterInvalidValue
HttpNotAllowed
Bloqué
Bing retourne InvalidRequest à chaque fois que la demande comporte une partie non valide. Par exemple, un paramètre obligatoire est manquant ou une valeur de paramètre n’est pas valide.

Si l’erreur est ParameterMissing ou ParameterInvalidValue, le code d’état HTTP est 400.

Si vous utilisez le protocole HTTP au lieu du protocole HTTPS, Bing retourne HttpNotAllowed, et le code d’état HTTP est 410.
RateLimitExceeded Aucun sous-code Bing retourne RateLimitExceeded chaque fois que vous dépassez votre quota de requêtes par seconde (QPS) ou par mois (QPM).

Si vous dépassez votre QPS, Bing retourne le code d’état HTTP 429 ; si vous dépassez votre QPM, Bing retourne le code d’état 403.
InvalidAuthorization AuthorizationMissing
AuthorizationRedundancy
Bing retourne InvalidAuthorization s’il ne parvient pas à identifier l’appelant. Par exemple, l’en-tête Ocp-Apim-Subscription-Key est manquant ou la clé d’abonnement n’est pas valide.

Il y a redondance si plusieurs méthodes d’authentification sont spécifiées.

Si l’erreur est InvalidAuthorization, le code d’état HTTP est 401.
InsufficientAuthorization AuthorizationDisabled
AuthorizationExpired
Bing retourne InsufficientAuthorization lorsque l’appelant n’est pas autorisé à accéder à la ressource. Cela peut se produire si la clé d’abonnement a été désactivée ou a expiré.

Si l’erreur est InsufficientAuthorization, le code d’état HTTP est 403.

Codes de marché

Le /news/search tableau suivant endpointhe répertorie les valeurs de code de marché que vous pouvez utiliser pour spécifier le mkt paramètre de requête. Bing retourne uniquement le contenu pour ces marchés. La liste est susceptible d’être modifiée.

Pour obtenir la liste des codes pays que vous pouvez spécifier dans le paramètre de requête cc, consultez Codes pays.

Pays/Région Langage Code du marché
Danemark Danois da-DK
Autriche Allemand de-AT
Belgique Néerlandais nl-BE
Suisse Allemand de-CH
Allemagne Allemand de-DE
Australie Anglais en-AU
Canada Anglais en-CA
Royaume-Uni Anglais en-GB
Indonésie Anglais en-ID
Irlande Anglais en-IE
Inde Anglais en-IN
Malaisie Anglais en-MY
Nouvelle-Zélande Anglais en-NZ
République des Philippines Anglais en-PH
Singapour Anglais en-SG
États-Unis Anglais fr-FR
Anglais général en-WW
Anglais général en-XA
Afrique du Sud Anglais en-ZA
Argentine Espagnol es-AR
Chili Espagnol es-CL
Espagne Espagnol es-ES
Mexique Espagnol es-MX
États-Unis Espagnol es-US
Espagnol général es-XL
Finlande Finnois fi-FI
France Français fr-BE
Canada Français fr-CA
Suisse Français fr-CH
France Français fr-FR
Italie Italien it-IT
Hong Kong (R.A.S.) Chinois traditionnel zh-HK
Taïwan Chinois traditionnel zh-TW
Japon Japonais ja-JP
Corée du Sud Coréen ko-KR
Pays-Bas Néerlandais nl-NL
République populaire de Chine Chinois zh-CN
Pologne Polonais pl-PL
Brésil Portugais pt-br
Russie Russe ru-RU
Suède Suédois sv-SE
Turquie Turc tr-TR

Pour le point de terminaison /news, le tableau suivant répertorie les valeurs de code de marché que vous pouvez utiliser pour spécifier le paramètre de requête mkt. Bing retourne uniquement le contenu pour ces marchés. La liste est susceptible d’être modifiée.

Pour obtenir la liste des codes pays que vous pouvez spécifier dans le paramètre de requête cc, consultez Codes pays.

Pays/Région Langage Code du marché
Danemark Danois da-DK
Allemagne Allemand de-DE
Australie Anglais en-AU
Royaume-Uni Anglais en-GB
États-Unis Anglais fr-FR
Anglais général en-WW
Chili Espagnol es-CL
Mexique Espagnol es-MX
États-Unis Espagnol es-US
Finlande Finnois fi-FI
Canada Français fr-CA
France Français fr-FR
Italie Italien it-IT
Portugais Brésil pt-br
République populaire de Chine Chinois zh-CN

Le /news/trendingtopics tableau suivant endpointhe répertorie les valeurs de code de marché que vous pouvez utiliser pour spécifier le mkt paramètre de requête. Bing retourne uniquement le contenu pour ces marchés. La liste est susceptible d’être modifiée.

Pour obtenir la liste des codes pays que vous pouvez spécifier dans le paramètre de requête cc, consultez Codes pays.

Pays/Région Langage Code du marché
Allemagne Allemand de-DE
Australie Anglais en-AU
Royaume-Uni Anglais en-GB
États-Unis Anglais fr-FR
Canada Anglais en-CA
Inde Anglais en-IN
France Français fr-FR
Canada Français fr-CA
Portugais Brésil pt-br
République populaire de Chine Chinois zh-CN

Codes de pays

Vous trouverez ci-dessous les codes pays que vous pouvez spécifier dans le paramètre de requête cc. La liste est susceptible d’être modifiée.

Pays/Région Indicatif de pays
Argentine AR
Australie AU
Autriche AT
Belgique BE
Brésil BR
Canada CA
Chili CL
Danemark DK
Finlande FI
France FR
Allemagne DE
Hong Kong (R.A.S.) HK
Inde IN
Indonésie id
Italie IT
Japon JP
Corée du Sud KR
Malaisie MY
Mexique MX
Pays-Bas NL
Nouvelle-Zélande NZ
Norvège Non
République populaire de Chine CN
Pologne PL
Portugal PT
République des Philippines PH
Russie RU
Arabie Saoudite SA
Afrique du Sud ZA
Espagne ES
Suède SE
Suisse CH
Taïwan TW
Turquie TR
Royaume-Uni Go
États-Unis US

Langues prises en charge par Bing

voici les Bing langues prises en charge que vous pouvez spécifier dans le setLang paramètre de requête. La liste est susceptible d’être modifiée.

Langues prises en charge Code de langue
Arabe ar
Basque eu
Bengali bn
Bulgare bg
Catalan ca
Chinois (simplifié) zh-hans
Chinois (traditionnel) zh-hant
Croate hr
Tchèque cs
Danois da
Néerlandais nl
Anglais en
English-United du Royaume-Uni en-gb
Estonien et
Finnois fi
Français fr
Galicien gl
Allemand de
Goudjrati gu
Hébreu he
Hindi hi
Hongrois hu
Islandais is
Italien it
Japonais JP
Kannada kn
Coréen ko
Letton lv
Lituanien lt
Malais ms
Malayalam ml
Marathi mr
Norvégien (bokmål) nb
Polonais pl
Portugais (Brésil) pt-br
Portugais (Portugal) pt-pt
Pendjabi pa
Roumain ro
Russe ru
Serbe (Cyrylic) sr
Slovaque sk
Slovène sl
Espagnol es
Suédois sv
Tamoul ta
Télougou te
Thaï th
Turc tr
Ukrainien uk
Vietnamien vi