# 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`.

**score_gte** - Optional  
Minimum match score, 0-10. Default: `4`. Set `0` to disable the floor.

**score_lte** - Optional  
Maximum match score, 0-10. Omit it for no upper bound. `score_gte` cannot be greater than `score_lte`.

**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.