---
title: "Financial-market news articles"
method: GET
path: "/1/market"
tags: ["Market"]
---

# Financial-market news articles

`GET /1/market`

Returns financial-market news articles tagged with stock ticker symbols. Available on plans with market access. On the free plan, articles cover the last 7 days with a 12-hour delay, and `from_date`, `to_date`, and `timeframe` cannot be used. On paid plans, use either `from_date`/`to_date` or `timeframe` (not both); when no dates are given, articles from the last 48 hours are returned.

Consumes **1** API credit per call.

## Query parameters

- `apikey` string
- `q` string
- `qInTitle` string
- `qInMeta` string
- `symbol` string[]
- `country` string[]
- `excludecountry` string[]
- `language` string[]
- `excludelanguage` string[]
- `domain` string[]
- `domainurl` string[]
- `excludedomain` string[]
- `prioritydomain` 'top' | 'medium' | 'low'
- `id` string[]
- `url` string, uri
- `from_date` string
- `to_date` string
- `timeframe` string
- `timezone` string
- `image` '0' | '1'
- `video` '0' | '1'
- `full_content` '0' | '1'
- `removeduplicate` '0' | '1'
- `sentiment` 'positive' | 'neutral' | 'negative'
- `sentiment_score` number
- `tag` string[]
- `organization` string[]
- `creator` string[]
- `datatype` string[]
- `size` integer
- `page` string
- `sort` 'pubdatedesc' | 'pubdateasc' | 'relevancy' | 'source' | 'fetched_at'
- `excludefield` string[]

## Response `200`

Success.

- MarketArticleListEnvelope — Successful market article list response.
  - `status` 'success', required
  - `totalResults` integer, required — Total number of articles matching the query (not just this page).
  - `results` MarketArticle[], required
    - `article_id` string, required — Unique article identifier (32 characters).
    - `link` string, uri, nullable — Article URL.
    - `title` string, nullable — Article title.
    - `description` string, nullable — Short article description.
    - `content` string, nullable — Full article text. Plan-specific (full-content access). Omitted when `full_content=0`.
    - `keywords` string[], nullable — Article keywords.
    - `creator` string[], nullable — Article author(s).
    - `symbol` string[], nullable — Stock ticker symbols the article mentions.
    - `language` string, nullable — Language name, e.g. 'english'.
    - `country` string[], nullable — Country names, e.g. 'india'.
    - `datatype` string — Content type, e.g. 'news', 'blog', 'podcast'.
    - `pubDate` string, nullable — Publish date, `YYYY-MM-DD HH:MM:SS`, in the requested `timezone`.
    - `pubDateTZ` string — Timezone of the dates in this article. 'UTC' unless `timezone` was supplied.
    - `fetched_at` string, nullable — When the article was collected, `YYYY-MM-DD HH:MM:SS`.
    - `image_url` string, uri, nullable — Article image URL.
    - `video_url` string, uri, nullable — Article video URL.
    - `source_id` string, nullable — Source id (usable with the `domain` filter).
    - `source_name` string, nullable — Source display name.
    - `source_priority` integer, nullable — Source ranking (lower = higher-ranked).
    - `source_url` string, uri, nullable — Source website URL.
    - `source_icon` string, uri, nullable — Source icon URL.
    - `sentiment` union — Overall sentiment: positive, neutral, or negative. Plan-specific (Professional/Corporate).
      - 'positive' | 'neutral' | 'negative'
      - string
    - `sentiment_stats` union — Sentiment percentage breakdown. Plan-specific (Professional/Corporate).
      - SentimentStats — Sentiment percentage breakdown. The three values sum to 100.
        - `positive` number, required
        - `neutral` number, required
        - `negative` number, required
      - string
    - `ai_tag` union — AI-classified topic tags. Plan-specific (Professional/Corporate).
      - string[]
      - string
    - `ai_org` union — AI-extracted organization names. Plan-specific (Corporate).
      - string[]
      - string
    - `ai_summary` string, nullable — AI-generated article summary. Plan-specific.
    - `duplicate` boolean — Whether the article is a duplicate of another article.
  - `nextPage` string, nullable — Pass this value as the `page` parameter to get the next page. `null` when there are no more results.

## Other responses

- `400` — Invalid request — e.g. a required parameter is missing or the search query is malformed.
- `401` — Missing or invalid API key, or the request is not allowed for this key.
- `403` — Your plan does not include access to this endpoint or parameter.
- `422` — A parameter value is not supported — e.g. an unknown filter value, too many values, an invalid date, or two incompatible filters used together.
- `429` — Too many requests in a short period, rate limit exceeded, or API credits exhausted.
- `500` — Unexpected server error. Please try again later.
- `503` — The endpoint is temporarily unavailable due to maintenance.

---

[API](https://skmtc.net/newsdata/apis/newsdata-io-api.md) · [All operations](https://skmtc.net/newsdata/apis/newsdata-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/newsdata/newsdata-io-api/versions/e58d9cb39db7/schema)