---
title: "Search news articles"
method: GET
path: "/v1/news/search"
tags: ["News"]
---

# Search news articles

`GET /v1/news/search`

## Request

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

Search news articles by keyword. Costs 3 weight per request.

## Query parameters

- `q` string

## Response `200`

Success.

- object
  - `success` boolean, required
  - `article` object
    - `id` string
    - `title` string
    - `description` string
    - `url` string
    - `source` string
    - `publishedAt` string, date-time
    - `imageUrl` string
    - `sentiment` string
    - `symbols` unknown[]
      - unknown
    - `category` string
    - `sentimentScore` number
    - `relevanceScore` number
    - `marketImpact` string
    - `keyTopics` string[]
    - `subcategory` string
    - `entities` object
      - `orgs` string[]
      - `people` unknown[]
        - unknown
      - `locations` unknown[]
        - unknown
    - `tickers` string[]
  - `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)