# Request Parameters

All parameters are sent in the JSON body.

**query** - Required  
Your topic or question. Maximum 750 characters and 100 words.

**k** - Optional  
Maximum number of articles to return. Default: `10`. Maximum: `100`.

**filters** - Optional  
Use [Filters](news-search-api-filters) to narrow the results.

**allow\_multiple\_chunks\_per\_article** \- Optional

When `allow_multiple_chunks_per_article` is set to `true`, the API may return multiple relevant chunks from the same article.

Each chunk represents a different relevant section of the article, while article-level fields such as the URL, title, and source remain the same. As a result, multiple results may appear to be duplicates, even though each result contains a different matching passage from the article.

By default, only one chunk per article is returned.

## Query limits

- Maximum 750 characters
- Maximum 100 words

If the query is too long, the request is rejected and no credits are charged.
