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 keyWhat 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
| Data | What the API holds | Starts | Refreshed |
|---|---|---|---|
| Gulf news | 900,822 stories; 42 outlets read today | January 2008 | Every 10 minutes |
| DFM companies | 71 listed today, each with its price line | – | Prices every 10 minutes while the market is open (last read 04:33 GST, 16 Nov) |
| Daily prices | Every trading day of each share, to 13 Nov 2026 | 31 Dec 2024 | After each trading day |
| Disclosures | 42,908 in English and 42,745 in Arabic | 2000 | Every 10 minutes |
| Text of documents | 25,090 of the 83,522 files attached to disclosures since then | 10 Jun 2001 | Every 10 minutes for text inside a file; scanned pages are read later |
| Exchange calendar | 156 dates | October 2026 | After 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
| Endpoint | What it returns | A call costs |
|---|---|---|
GET /api/v1/stories | Stories, 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/search | Stories about a subject, best match first. | 1 request for every 25 stories |
GET /api/v1/top | The 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/sources | Every outlet Ashum reads, when it was last checked, and whether that check worked. | 1 request |
GET /api/v1/topics | The seven sections stories are sorted into, and what each one covers. | 1 request |
GET /api/v1/companies | Everything 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/disclosures | What 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/calendar | The 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/flows | What 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-trades | The 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/sharia | The 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/brokers | DFM'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/series | The 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/usage | Where 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
curl "https://ashum.ai/api/v1/stories?topic=economy&limit=1" \
-H "Authorization: Bearer YOUR_KEY"{
"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 do | Requests | Cost |
|---|---|---|
| Checking for new stories every 10 minutes, for a 30-day month | 4,320 | $21.60 |
| Reading 1,000 stories | 40 | $0.20 |
| Reading the full text of 100 DFM disclosures, one call each | 100 | $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.