Oil News Index F6
Six fundamental questions put every day to about a thousand oil articles, next to the WTI and Brent moves. Daily since 2022.
Ready to paste
A prompt for your coding agent, curl, Python and a spreadsheet formula. Base URL, authentication, updates and terms are on the Data API page.
The examples need a key
Free, by email. Once it is saved in this browser, the examples below carry it.
Paste it into Claude Code, Codex, Cursor or your own agent, then say what you want done with the data. It tells the agent where the files are and how to read them.
You have access to the Oil News Index F6 (OIL-F6) from the Thinking Text free data API: a daily index of what the news says about crude oil, read by a language model from about a thousand oil articles a day, next to WTI and Brent.
Base URL: https://thinkingtext.com/api/v1/oil
Auth: send the header "X-API-Key: YOUR_API_KEY" with every request (or append ?key=YOUR_API_KEY to the URL).
Docs, file layout and field meanings: https://thinkingtext.com/data-api.md (section "Oil files")
Files:
- oil/spec.json: the six questions (demand, supply, inventories, OPEC, disruption, margins), their state words and the conventions. Read it before interpreting any value.
- oil/latest.json: the last complete press day: the index (f6), the six slots, the context line, prices and the attribution cards.
- oil/history/all.csv (or <year>.csv / .json): one row per market day since 2022.
- oil/today.json: provisional read of the current press day, every six hours (404 when there is none).
- oil/backtest.json: the back-analysis behind the index page's charts.
How to read it: values are z-scores of the news flow on a trailing year (standard deviations), signed toward a higher price. The read on market day t is the press of the next price day (press_day), so no row uses news written after the close it sits next to. k<K>_implied is the news-implied k-day move in percent.
Files change once a day (final values each morning UTC): download once and cache, don't poll.
Free for research and non-commercial use, with attribution ("Source: Thinking Text, thinkingtext.com"). News analysis for research and entertainment: not a forecast, not a trading signal and not investment advice.
With a key saved in this browser, the examples carry it, ready to paste.
The files
Download or view each file once a key is saved in this browser (get one free). The index page explains the numbers.
Daily history
One row per market day since 2022: the index, the six slots and their states, WTI and Brent closes and returns, the news-implied moves and the betas behind them. CSV and JSON, identical content.
Latest values, spec and back-analysis
latest: the read of the last complete press day, the six slots, the context line and the attribution cards. today: the provisional read, every six hours. spec: the questions, their state words and the conventions. backtest: every number of the page's charts.
A research project provided for information only. It describes what the press is saying; it is not a forecast and not investment advice. No article text, outlet list, question wording, prompt or per-article score is published.