ASHUMGulf news and Dubai stocks, live

API pricing

Gulf news and Dubai Financial Market data for your app, as JSON. You pay for the requests you make, with no subscription. Reading Ashum itself is free.

$0.005 a request$5 per 1,000 requests

Subscription
None. Nothing renews; add more whenever you like
New accounts
200 free requests, no card needed
Smallest top-up
$20, which is 4,000 requests
Largest top-up
$1,000, which is 200,000 requests

In whole dollars. You pay once, on Stripe’s page. Your card statement will read CONVERTLYFT AI, the company that runs Ashum.

Try it first. The free requests reach stories, DFM data, exchange rates, fuel prices and oil spot prices from the last 30 days; the whole archive opens once you add funds.

Get a key

What you get

Gulf news
Headlines from 42 outlets, checked every 10 minutes, with publisher, time, summary and link
Sections
Every story sorted into one of seven sections, and the same story grouped across outlets
Archive, search
Back to January 2008 once you have added funds; search by meaning and by words
DFM companies
Every listed company with its price line, read every 10 minutes while the market is open
Daily prices
Open, high, low, close, volume and value traded, for every trading day of each share
Disclosures
What those companies file, with the text of the documents and a link to each original file
Calendar
Board meetings, general assemblies, earnings calls and dividend dates
Limits
300 requests a minute for each key, and 10 keys
One flat price
$0.005 a request, whichever endpoint you call
Refunds
Unused funds are refunded on request within 14 days. Terms

What is covered

DataWhat the API holdsStartsRefreshed
Gulf news900,822 stories; 42 outlets read todayJanuary 2008Every 10 minutes
DFM companies71 listed today, each with its price line–Prices every 10 minutes while the market is open (last read 04:33 GST, 16 Nov)
Daily pricesEvery trading day of each share, to 13 Nov 202631 Dec 2024After each trading day
Disclosures42,908 in English and 42,745 in Arabic2000Every 10 minutes
Text of documents25,090 of the 83,522 files attached to disclosures since then10 Jun 2001Every 10 minutes for text inside a file; scanned pages are read later
Exchange calendar156 datesOctober 2026After each trading day

Not in the API. The stock pages of Ashum also show what analysts expect (ratings and price targets, from Yahoo Finance) and daily prices from before 31 December 2024; the API serves neither. The oil page shows futures closes from Yahoo Finance; the API serves the US Energy Information Administration’s spot prices for Brent and WTI and not the futures. Companies listed in Abu Dhabi (ADX) are not covered, and shares listed on Nasdaq Dubai are not included.

The archive starts in January 2008. Outlets joined at different times, so not every outlet reaches back that far. Search by meaning covers every outlet from January 2024 and part of the archive before it; every story can be found by its words. Ashum holds headlines and the outlets’ own summaries, not the full articles.

DFM disclosures go back to 2000, and DFM’s daily prices to 31 December 2024. Ashum reads the text of PDF documents filed since 13 November 2024; a file scanned from paper has text only once its pages have been read, and not every scan has been read yet. Of the files filed before that day, the English ones are being read too, newest first, and not all of them have their text yet.

Endpoints

EndpointWhat it returnsA call costs
GET /api/v1/storiesStories, newest first.1 request for every 25 stories
GET /api/v1/stories/{id}A single story, with the same story in other outlets and related coverage from the days around it.1 request
GET /api/v1/searchStories about a subject, best match first.1 request for every 25 stories
GET /api/v1/topThe stories that two or more outlets carried in the last 24 hours, the most widely carried first.1 request for every 25 stories
GET /api/v1/sourcesEvery outlet Ashum reads, when it was last checked, and whether that check worked.1 request
GET /api/v1/topicsThe seven sections stories are sorted into, and what each one covers.1 request
GET /api/v1/companiesEverything listed on Dubai Financial Market (DFM) today, in order of symbol: shares, funds, ETFs and REITs, each with its latest price.1 request
GET /api/v1/companies/{symbol}One DFM company as its page on ashum.ai shows it: the whole price line, its profile, the symbols it traded under before, the coming dates on DFM's calendar, and when it has filed its results in past years.1 request
GET /api/v1/disclosuresWhat DFM companies have filed with the exchange, newest first: results, board decisions, dividends, notices.1 request for every 25 disclosures
GET /api/v1/disclosures/{id}A single disclosure with the text of each attached document, a page at a time, and the address of the original file at DFM.1 request
GET /api/v1/prices/{symbol}A share's daily prices as DFM gives them, oldest first, in UAE dirhams.1 request
GET /api/v1/financials/{symbol}A DFM company's headline figures by period: revenue (or, for a bank, total income), profit, cash from operations, total assets and total equity.1 request
GET /api/v1/calendarThe dates on DFM's calendar: board meetings, general assemblies, earnings calls and the dates of a dividend.1 request
GET /api/v1/ownership/{symbol}How a DFM company's shares are held by the holder's nationality, by session, newest first, with the limit on foreign holders; and its largest shareholders as DFM lists them.1 request
GET /api/v1/flowsWhat each kind of investor, and investors of each nationality, bought and sold on DFM in a session, newest session first, in UAE dirhams.1 request
GET /api/v1/block-tradesThe block trades DFM lists (it calls them direct deals), newest first, in UAE dirhams.1 request
GET /api/v1/margin/{symbol}A DFM share's margin trading by week, newest first, in UAE dirhams, as DFM's weekly report gives it: the shares available for margin trading, and what was bought and sold on margin in the week.1 request
GET /api/v1/shariaThe DFM companies on DFM's own list of Shari'a-compliant companies for a quarter: the newest list held, or the quarter asked for.1 request
GET /api/v1/brokersDFM's ranking of its brokers for a month, first by the value they traded, in UAE dirhams, with each broker's share of the market's value, volume and trades.1 request
GET /api/v1/seriesThe dated figures Ashum keeps, each with its latest value.1 request
GET /api/v1/series/{code}One dated figure day by day, newest first.1 request
GET /api/v1/usageWhere the account stands: the requests it holds, what they are worth, and how many calls it made today.Free

All 22 endpoints; each address opens its section of the API docs, with what it takes and a sample answer. One request is $0.005.

What one request returns

Request
curl "https://ashum.ai/api/v1/stories?topic=economy&limit=1" \
  -H "Authorization: Bearer YOUR_KEY"
Answer
{
  "data": [
    {
      "id": "412345",
      "headline": "Example headline, exactly as the publisher wrote it",
      "summary": "The publisher's own first lines of the story.",
      "url": "https://publisher.example/the-story",
      "source": { "id": "wam", "name": "WAM" },
      "topic": "economy",
      "published_at": "2026-11-10T08:15:00.000Z"
    }
  ],
  "next_cursor": "MjAyNi0xMS0xMFQwODoxNTowMC4wMDBafDQxMjM0NQ"
}

The shape is real; the story in it is a placeholder.

What it costs

What you doRequestsCost
Checking for new stories every 10 minutes, for a 30-day month4,320$21.60
Reading 1,000 stories40$0.20
Reading the full text of 100 DFM disclosures, one call each100$0.50
$20, the smallest amount you can add (up to 100,000 stories)4,000$20.00

How requests are counted

  • A call that returns a list of stories costs one request for every 25 stories, or part of 25. A list of DFM disclosures is counted the same way. Any other call costs one request.
  • A call that returns an error is not charged.
  • Checking your balance is free.
  • Requests stay on your account until used. When they run out, calls stop; nothing more is charged.

A question about a payment or the API? Write to support@convertlyft.com.