Le paramètre count de Brave limite-t-il aussi les résultats d’actualité et de recherche de lieux ?

Définition : Non. Dans l’API Web Search de Brave, count détermine le nombre de résultats web renvoyés, même lorsque le filtre de réponse désigne d’autres types de résultats. News Search et Place Search documentent leurs propres nombres de résultats sur leurs points de terminaison (endpoints) dédiés.

Points clés

• Le paramètre count de Web Search de Brave indique le nombre de résultats demandé dans la réponse, avec un maximum et une valeur par défaut de 20 ; le nombre renvoyé peut être inférieur. La référence de l’API Web Search de Brave documente ce comportement.
• Web Search accepte news et locations dans result_filter, aux côtés de web et d’autres types de résultats. La même référence précise que count s’applique uniquement aux résultats web.
• La référence de News Search de Brave indique un maximum de 50 et une valeur par défaut de 20 pour son paramètre count, avec un nombre de résultats potentiellement inférieur selon la requête. La référence de News Search documente ce réglage distinct.
• La référence de Place Search de Brave définit count comme le nombre de résultats à renvoyer, avec un maximum de 100 et une valeur par défaut de 20. La référence de Place Search documente la limite de ce point de terminaison.

Que contrôle count dans Web Search ?

Brave décrit Web Search comme une recherche dans un index indépendant de pages web. Son paramètre count correspond au nombre de résultats de recherche demandé, avec un maximum de 20 et une valeur par défaut de 20. L’API peut renvoyer moins de résultats que demandé. offset fonctionne avec count pour paginer ces résultats web, et sa plage de valeurs documentée va de 0 à 9.

Le paramètre result_filter sélectionne les types de résultats à inclure dans la réponse. Ses valeurs documentées comprennent web, news et locations, ainsi que discussions, faq, infobox, query, summarizer et videos. La note de Brave située directement sous cette liste limite l’application de count aux résultats web.

count=10
result_filter=web,news,locations
offset=0

Cette configuration demande une réponse mixte à Web Search, tandis que le réglage du nombre de résultats reste propre aux résultats web. La référence précise également que l’omission de result_filter renvoie tous les types de résultats pour lesquels des données sont disponibles et dont l’option correspondante est activée dans l’offre souscrite.

Comment les résultats d’actualité sont-ils comptés ?

News Search dispose d’un point de terminaison GET distinct à l’adresse /v1/news/search. Brave le décrit comme une recherche de contenus d’actualité dans un index indépendant de pages web. Son propre paramètre count a un maximum de 50 et une valeur par défaut de 20. Le nombre effectif peut être inférieur au nombre demandé selon la requête.

News Search utilise offset avec count pour la pagination. Brave décrit offset comme le nombre de groupes de résultats, chacun de la taille demandée par count, à ignorer, avec un maximum de 9 et une valeur par défaut de 0. La référence précise que les résultats peuvent se recouper entre plusieurs pages.

GET /v1/news/search
count=50
offset=0

Ces limites concernent News Search. Une valeur count dans une requête Web Search ne devient pas un plafond de résultats d’actualité par l’ajout de result_filter=news.

Comment les résultats de recherche de lieux sont-ils comptés ?

Place Search dispose d’un point de terminaison GET distinct à l’adresse /v1/local/place_search. Brave le décrit comme une recherche de points d’intérêt dans une zone. Si aucun q n’est fourni, ce point de terminaison renvoie des points d’intérêt généraux dans la zone indiquée.

Son paramètre count est défini comme le nombre de résultats à renvoyer. Le maximum documenté est de 100 et la valeur par défaut de 20. La réponse indique qu’elle est de type locations, ce qui correspond à la valeur locations disponible dans le filtre de résultats de Web Search.

GET /v1/local/place_search
count=100

Pour une application qui doit fixer un nombre maximal de résultats d’actualité ou de recherche de lieux, le réglage pertinent est le paramètre count du point de terminaison dédié. La référence de Web Search ne fournit aucun plafond commun pour ces types de résultats.

Termes associés

• Brave Search API
• Le paramètre offset de Brave compte-t-il les résultats ou les pages de résultats ?
• Localisation de Brave Search

Questions fréquentes

count=50 demande-t-il 50 résultats Web Search ?

Non. Web Search documente un maximum de 20 pour count ; News Search documente un maximum distinct de 50.

result_filter=news peut-il faire appliquer le paramètre count de Web Search aux actualités ?

Non. La référence de Web Search de Brave précise que count s’applique uniquement aux résultats web. News Search possède son propre paramètre count et ses propres paramètres de pagination.

Quel est le maximum documenté pour Place Search ?

Place Search documente un maximum de 100 pour count et une valeur par défaut de 20.

Sources

1. Brave Search API, « Search », sans date
2. Brave Search API, « News Search », sans date
3. Brave Search API, « Place Search », sans date

---

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO