---
title: "Perform a news search using the Brave Search API."
method: POST
path: "/newsSearch"
---

# Perform a news search using the Brave Search API.

`POST /newsSearch`

This function allows users to search for news articles using the Brave Search API. It provides a wide range of parameters to customize the search, including query, country, language, and result filtering options. The function returns a promise that resolves to a detailed news search response containing article information and metadata.

## Request body

- object
  - `body` object — Body of the newsSearch sls call
    - `arguments` object, required — Parameters for the news search function
      - `q` string, required — The search query (max 400 characters, 50 words)
      - `country` string — 2-letter country code
      - `search_lang` string — Search language
      - `ui_lang` string — UI language
      - `count` integer — Number of results (1-20)
      - `offset` integer — Offset for pagination (0-9)
      - `safesearch` 'off' | 'moderate' | 'strict' — Safe search level
      - `freshness` union — Freshness of results
        - 'pd' | 'pw' | 'pm' | 'py' — Predefined freshness options
        - string — Custom date range in format 'YYYY-MM-DDtoYYYY-MM-DD'
      - `text_decorations` boolean — Include decoration markers
      - `spellcheck` boolean — Enable spellchecking
      - `result_filter` string — Comma-separated list of result types
      - `goggles` string[] — Goggle definitions for custom re-ranking
      - `units` 'metric' | 'imperial' — Units for measurements
    - `constructor` 'createBraveSDK' — Name of the constructor to use.

## Response `200`

Successful news search response

- object
  - `type` 'news'
  - `query` object
    - `original` string
    - `altered` string
    - `cleaned` string
  - `results` object[]
    - `type` 'news_result'
    - `url` string
    - `title` string
    - `description` string
    - `age` string
    - `page_age` string
    - `page_fetched` string
    - `breaking` boolean
    - `thumbnail` object
      - `src` string
      - `width` integer
      - `height` integer
    - `meta_url` object
      - `source` string
      - `domain` string
    - `extra_snippets` string[]

## Other responses

- `400` — Bad request - invalid parameters
- `401` — Unauthorized - invalid or missing API key
- `429` — Too Many Requests - rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/microfox-ai/apis/brave-search.md) · [All operations](https://skmtc.net/microfox-ai/apis/brave-search/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/microfox-ai/brave-search/revisions/2284eaa411cf/schema)