# Querying Atlas News

Discover current filter values and supported parameters in [filters.json](https://atlas-extractions.minestarters.com/news/filters.json).
Discover all populated regions, commodities, and pairs in [topics.json](https://atlas-extractions.minestarters.com/news/topics.json), including values outside the limited filter dropdown lists.
Use /news for HTML or /news.md for Markdown with the same query parameters.

## Examples
- [Lithium mining news in Saskatchewan](https://atlas-extractions.minestarters.com/news.md?commodities=lithium&regions=canada_sk&page_size=10)
- [British Columbia](https://atlas-extractions.minestarters.com/news.md?regions=canada_bc)
- [Gold](https://atlas-extractions.minestarters.com/news.md?commodities=gold)
- [Gold in British Columbia or Ontario](https://atlas-extractions.minestarters.com/news.md?commodities=gold&regions=canada_bc,canada_on)
- [Dated news](https://atlas-extractions.minestarters.com/news.md?published_after=2026-08-01&published_before=2026-08-31)
- [Bullish copper](https://atlas-extractions.minestarters.com/news.md?commodities=copper&sort=bullish)
- [Second page](https://atlas-extractions.minestarters.com/news.md?commodities=gold&page=2&page_size=50)

## Semantics
Region values match exactly: canada does not include canada_bc or other provincial values. Combine the appropriate values returned by filters.json.
Within a region or commodity filter, comma-separated values select alternatives. Commodity filters match the primary commodity. Different filter dimensions combine to narrow results.
Dates are inclusive YYYY-MM-DD; sentiment_min and sentiment_max range from -1 to 1. q searches titles. companies accepts company tickers; etfs accepts ETF symbols.
sort supports latest, bullish, and bearish. page is one-based; page_size is capped at 200. HTML defaults to 10 stories and Markdown to 50; specify page_size for matching pages. Follow the returned previous/next links.
Atlas coverage is fixed to drill_results, resource_update, and metallurgy (any by default). document_types cannot widen or replace this coverage. document_type_match=all with document_types present requires all three coverage types.
Unknown parameters and invalid values follow HTML normalization. Empty results are reported explicitly; upstream failures return 503, not an empty feed.
Each result links to its permanent Atlas analysis and original publisher. Cite these sources rather than treating Atlas as the original reporter.
