---
title: "News filter values with counts"
method: GET
path: "/v1/news/filters"
tags: ["News"]
---

# News filter values with counts

`GET /v1/news/filters`

## Request

- Base URL: `https://api.metalcharts.org`
- URL: `https://api.metalcharts.org/v1/news/filters`
- Auth: none declared

Every filter value available on the news endpoints, with a count per value: sources, categories and symbols. Call this to build a filter UI rather than hard-coding the options.

## Response `200`

Success.

- object
  - `success` boolean, required
  - `filters` object
    - `sources` object[]
      - `count` number
      - `label` string
      - `value` string
    - `categories` object[]
      - `count` number
      - `label` string
      - `value` string
    - `symbols` object[]
      - `count` number
      - `label` string
      - `value` string
    - `sourceTypes` unknown[]
      - unknown
  - `totalArticles` number
  - `timestamp` string, date-time

## Other responses

- `400`: Invalid parameter.

---

[API](https://skmtc.dev/metalcharts/apis/metalcharts-api.md) · [All operations](https://skmtc.dev/metalcharts/apis/metalcharts-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metalcharts/apis/metalcharts-api/revisions/53d6a0af0479?raw)