Does Brave's count setting also cap news and location results?

The Citead team, updated

In short. Brave's Web Search count parameter applies only to web results; News Search and Place Search define their own limits.

Definition: No. In Brave's Web Search API, count controls the number of web results returned, even when the response filter names other result types. News Search and Place Search document their own result counts on their dedicated endpoints.

Key facts

  • Brave's Web Search count parameter requests the number of results in the response, with a maximum and default of 20; the delivered number can be lower. Brave's Web Search API reference documents this behavior.
  • Web Search accepts news and locations in result_filter, alongside web and other result types. The same reference states that count applies only to web results.
  • Brave's News Search reference gives its count parameter a maximum of 50 and a default of 20, with fewer results possible for a query. The News Search reference documents the separate setting.
  • Brave's Place Search reference defines count as the number of results to return, with a maximum of 100 and a default of 20. The Place Search reference documents that endpoint's limit.

Brave describes Web Search as a search over an independent index of web pages. Its count parameter is the requested number of search results, with a maximum of 20 and a default of 20. The API can return fewer results than requested. offset works with count to paginate these web results, and the documented offset range is 0 to 9.

The result_filter parameter selects result types for the response. Its documented values include web, news, and locations, as well as discussions, faq, infobox, query, summarizer, and videos. Brave's note directly below that list limits count to web results.

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

This configuration asks the Web Search request for a mixed response while the count setting remains a web-result setting. The reference also says that omitting result_filter returns all result types for which data is available and the plan has the corresponding option activated.

How are news results counted?

News Search is a separate GET endpoint at /v1/news/search. Brave describes it as searching news content from an independent index of web pages. Its own count parameter has a maximum of 50 and a default of 20. The actual number can be lower than requested based on the query.

News Search uses offset with count for pagination. Brave describes offset as the number of result sets of the requested count to skip, with a maximum of 9 and a default of 0. The reference says that results may overlap across multiple pages.

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

These limits belong to News Search. A count value in a Web Search request does not become a news-result cap through result_filter=news.

How are location results counted?

Place Search is a separate GET endpoint at /v1/local/place_search. Brave describes it as a search for points of interest in an area. If no q is provided, the endpoint returns general points of interest in the given area.

Its count parameter is defined as the number of results to return. The documented maximum is 100 and the default is 20. The response identifies itself with the type locations, which matches the locations value available to Web Search's result filter.

GET /v1/local/place_search
count=100

For an application that needs a news or location result budget, the relevant setting is the count parameter on the dedicated endpoint. The Web Search reference supplies no shared cap for those result types.

FAQ

Does count=50 request 50 Web Search results?

No. Web Search documents a maximum of 20 for count; News Search documents the separate maximum of 50.

Can result_filter=news make Web Search's count apply to news?

No. Brave's Web Search reference states that count applies only to web results. News Search has its own count and pagination parameters.

Place Search documents a maximum count of 100 and a default of 20.

Sources

  1. Brave Search API, "Search", undated
  2. Brave Search API, "News Search", undated
  3. Brave Search API, "Place Search", undated

Check how a page reads to answer engines. Open the GEO score analyzer

Test a page and see what to fix first

The analysis usually takes less than 10 seconds and needs no account.

400,000+ pages scored in the public benchmark