Market news API

Start in 3 steps

1. 01

   Create an API key

   Create your key in the developer console and send it with every request.

2. 02

   Send a request

   Call GET /market-news with your key in the X-API-Key header.

3. 03

   Receive the data

   Each story returns bilingual titles, a category, a market, and impact scores.

curl "https://www.brieflynewsstream.com/api/v1/market-news" \
  -H "X-API-Key: YOUR_KEY"

{
  "id": "...",
  "title": "أسواق الأسهم العالمية تتماسك مع ترقّب قرارات الفائدة",
  "summary": "الأسواق تبقى منتظمة بينما ينتظر المتعاملون الخطوة التالية في السياسة النقدية.",
  "arabic": {
    "title": "أسواق الأسهم العالمية تتماسك مع ترقّب قرارات الفائدة",
    "summary": "الأسواق تبقى منتظمة بينما ينتظر المتعاملون الخطوة التالية في السياسة النقدية."
  },
  "english": {
    "title": "Global equities hold as desks watch the next rate decision",
    "summary": "Stock markets stay orderly while traders wait for the next move in policy."
  },
  "category": "markets",
  "country": "GLOBAL",
  "publishedAt": "2026-08-21T12:00:00.000Z",
  "scores": {
    "final": 86,
    "marketImpact": 84
  }
}

Authentication

Send your API key in the X-API-Key header on every news request.

X-API-Key: YOUR_KEY

Create keys in the developer console.

Market News API

GET /market-news

Fetch the latest stories with the filters your product needs.

Public endpoints

Parameters

Example

GET /market-news?region=global&category=markets&sort=score&limit=10

Data built for code

Every story uses the same fields.

{
  "id": "...",
  "title": "أسواق الأسهم العالمية تتماسك مع ترقّب قرارات الفائدة",
  "summary": "الأسواق تبقى منتظمة بينما ينتظر المتعاملون الخطوة التالية في السياسة النقدية.",
  "arabic": {
    "title": "أسواق الأسهم العالمية تتماسك مع ترقّب قرارات الفائدة",
    "summary": "الأسواق تبقى منتظمة بينما ينتظر المتعاملون الخطوة التالية في السياسة النقدية."
  },
  "english": {
    "title": "Global equities hold as desks watch the next rate decision",
    "summary": "Stock markets stay orderly while traders wait for the next move in policy."
  },
  "category": "markets",
  "country": "GLOBAL",
  "publishedAt": "2026-08-21T12:00:00.000Z",
  "scores": {
    "final": 86,
    "marketImpact": 84
  }
}

• Title

  title, arabic, english

  title follows lang. arabic and english stay on the same object.

• Category

  category

  A fixed market category such as markets, finance, or oil.

• Market

  country, region

  country is an ISO code. region is middle_east, america, or global.

• Impact

  scores.final, scores.marketImpact

  scores.final and scores.marketImpact rank likely market effect.

• Date

  publishedAt

  publishedAt is an ISO 8601 timestamp.

Filter news the way your product needs

GET /market-news
  ?region=global
  &category=finance
  &lang=ar
  &sort=score
  &limit=20

Use sort=score to rank stories by impact, not only by recency.

Responses

JSON, UTF-8, Arabic and English fields, a stable envelope, and quota headers on every authenticated response.

• JSON with charset=utf-8
• Predictable item fields on every story
• title and summary follow lang. arabic and english stay present.
• Paginate with limit and offset. count is the unique-story total.
• X-API-Quota-Limit, X-API-Quota-Remaining, and X-API-Quota-Used.

{
  "meta": {
    "version": "1.0.0",
    "lang": "ar"
  },
  "count": 10,
  "limit": 10,
  "offset": 0,
  "items": []
}

Errors

Failures use a flat error code and a message.

{
  "error": "unauthorized",
  "message": "Missing or invalid API key."
}

Usage limits

Free includes 3 requests a day. Pro includes 500. Enterprise includes 20,000 by default. The daily limit renews automatically every day.

Default page size is 50. Maximum is 500.

Without from, to, or date, results use the default 72-hour live window. Indexed stories stay in the archive on every plan. Use from and to to query further back.

Use it the way your product needs

const response = await fetch(
  "https://www.brieflynewsstream.com/api/v1/market-news",
  {
    headers: {
      "X-API-Key": process.env.BRIEFLY_API_KEY
    }
  }
);
const data = await response.json();

curl "https://www.brieflynewsstream.com/api/v1/market-news" \
  -H "X-API-Key: YOUR_KEY"

import os
import urllib.request

req = urllib.request.Request(
    "https://www.brieflynewsstream.com/api/v1/market-news",
    headers={"X-API-Key": os.environ["BRIEFLY_API_KEY"]},
)
with urllib.request.urlopen(req) as response:
    print(response.read().decode())

$ch = curl_init("https://www.brieflynewsstream.com/api/v1/market-news");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: " . getenv("BRIEFLY_API_KEY"),
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
echo curl_exec($ch);

Try requests in the console