Preserve the public reference
Title, canonical URL, publisher, publication time, retrieval time, source ID, and symbol links remain attached to the record.
Stock news API
Query historical stock-news links with publication and retrieval timestamps
Retrieve company news titles, canonical URLs, publishers, publication times, retrieval times, source IDs, and symbol links. The open baseline returns link metadata and first-party references; full article text requires a suitable license.
Links
open baseline
2 clocks
published and retrieved
Entity
company resolution
Licensed only
full-text serving
Definition
A stock news API supplies article metadata, links, entities, timestamps, and sometimes licensed text. Historical research must distinguish when an item was published from when it entered the dataset and keep the exact source record used by the model.
How DataCedar handles it01 02 03 04
What you can query, which fields are returned, and how availability is reported.
Prefer first-party evidence
SEC filings, 8-K exhibits, and issuer announcements anchor material company events even when general-news coverage is incomplete.
Reconstruct discovery time
Known-at and retrieval timestamps let a researcher exclude links that had not entered the dataset before the simulated decision.
Keep full text licensed
General article bodies are not republished by default. Full text activates only for sources whose terms explicitly permit the product use.
Data surface
What the schema is built to carry.
Company news-link metadata
Publisher and canonical URL
Publication and retrieval timestamps
Ticker and issuer resolution
Filing and earnings-event links
Public GDELT reference ingestion
Source and rights class
Licensed full-text gate
Product boundary: The open product serves link metadata and public or first-party references, not a copy of general news articles. Headlines and metadata still carry source-specific rights and attribution requirements.
API example
Company news chronology
GET /v3/stocks/{symbol}/news
Request
curl "https://api.datacedar.com/v3/stocks/AAPL/news?limit=50" \
-H "X-API-Key: $QUARTERTRACE_API_KEY"Representative response
{
"data": [{
"symbol": "AAPL",
"title": "Source-provided headline",
"url": "https://publisher.example/article",
"publisher": "Publisher",
"published_at": "2026-07-16T13:30:00Z",
"retrieved_at": "2026-07-16T13:42:11Z",
"content_mode": "link_metadata"
}]
}Examples document the public contract and may use illustrative values or redacted identifiers. Availability fields and rights filters are authoritative for the active environment.
Research workflow
Four steps from API key to a validated dataset.
01
Collect
Acquire public link metadata or first-party company announcements with a source-specific adapter.
02
Timestamp
Keep publication, retrieval, and known-at times distinct.
03
Resolve
Map entities and tickers to a stable issuer, retaining ambiguous cases for review.
04
Align
Join references to filings, earnings events, facts, macro releases, and permitted market windows.
Field guide
Building historical news research without rewriting the archive
01
Publication time is not ingestion time
A publisher may update a page, expose an imprecise timestamp, or become discoverable by a collector minutes later. A backtest that uses the publisher's final timestamp without recording ingestion can overstate what the system actually knew.
DataCedar stores publication and retrieval separately and can derive a conservative known-at time. The raw reference response is preserved so timestamp corrections remain auditable.
- Normalize timezones without deleting source text.
- Retain updates as new versions when detectable.
- Use retrieval time as a conservative bound when publication time is uncertain.
02
Entity resolution is part of the dataset
A ticker in a headline can refer to a security, a product, or an unrelated word. Company names change and subsidiaries may not map cleanly to the listed parent.
DataCedar connects news references through the security master and keeps the source evidence behind each association. Low-confidence matches should be reviewable, not silently accepted into a training set.
- Resolve against issuer identity, not ticker text alone.
- Keep match evidence and method.
- Allow one item to relate to multiple companies.
03
Primary announcements reduce dependence on general news
Material company information often appears first in an 8-K exhibit, investor-relations release, or regulatory filing. Those sources are easier to trace and can remain useful even when article full text cannot be republished.
DataCedar links general-news metadata with SEC and issuer evidence rather than positioning scraped article content as the product. Licensed text can be added later without changing the event model.
- Prefer primary evidence for event identity.
- Keep publisher attribution on every link.
- Do not summarize content that was never lawfully acquired.
Comparison
News feed versus point-in-time news evidence
A feed helps someone read what is new. A research dataset must explain exactly what record was available to the model.
CriterionTypical latest-value feedDataCedar research model
ContentHeadline, snippet, or licensed articleLink metadata baseline; licensed text only
TimePublication timestampPublished, retrieved, and known-at
Company mappingTicker tagsStable issuer resolution plus evidence
CorrectionsLatest page or duplicate itemVersion and raw-response provenance
ContextNews stream aloneFilings, earnings, facts, macro, and market windows
Before you rely on it
A practical validation checklist.
- 01The source permits the stored fields and product use
- 02Publication and retrieval times are distinct
- 03Canonical URLs and publishers are retained
- 04Company matches are inspectable
- 05Updated or duplicate stories are handled deterministically
- 06Full text is served only under suitable rights
- 07Historical queries apply a conservative known-at cutoff
Questions, answered.
Not in the open baseline. It serves public link metadata and first-party references; article text requires a source license that permits the intended storage and serving.
Continue the research
Historical stock data →
Build historical stock price and volume exports with explicit adjustments, coverage checks, symbol history, and event windows for reproducible backtesting.
Stock market data API →
Query permitted stock price and volume beside SEC filings, earnings events, point-in-time fundamentals, news references, macro data, and coverage metadata.
SEC filings API →
Query SEC filing metadata, primary documents, exhibits, XBRL facts, and amendments with accession-level provenance and known-at timestamps.
Earnings calendar API →
Query scheduled, confirmed, rescheduled, and completed earnings events with known-at history, source evidence, fiscal periods, and reaction windows.
Create a free API key for filings, facts, earnings events, news links, and macro data.
Explorer is $0 with no card and a 1 request/second limit. Market history and transcript text appear only when an eligible source is active for the account.
Open DataCedar