Use casesFinancial news
Market-moving news, for agents that trade and research.
Company, ticker and macro news with a timestamp, a source and typed answers on every article — what kind of event, how material, whether it gives a number — in the same call.
POST /v1/searchmode: "normal" · $2.20 per 1,000 queries
The problem
An agent that reads the news has to read it right
A trading or research agent needs today’s news about a company or a market, not the most linked page about it. Web search returns evergreen pages; a headline feed returns everything that mentions a ticker, and the model has to sort out what matters.
Every step your agent takes on a wrong headline costs money. It needs fresh articles with a publication time and a source, read before they are trusted, and answers it can act on without a second LLM pass.
How it works
- 01
Ask about the company, not just the ticker
Queries like “Initech earnings guidance” or “Initech acquisition” — up to five per request, judged together.
- 02
Read before you trust
Normal mode opens the top 4 articles and verifies them before ranking. A headline that oversells its article drops out.
- 03
Typed answers per article
questions returns what kind of event it is, how material, and whether it gives a figure — as probabilities, choices and scores, based on the article text.
- 04
Only what’s new
days: 1, or published_after your last run. Stream results to act on the first confirmed article, about a second in.
API
The request
One request does it. The same parameters work over HTTP, with the SDKs and through the MCP server.
What it costs
Recommended · normal$2.20 per 1,000 queries
Normal reads the top 4 articles, so the typed answers are based on the text, not the headline.
Also good · fast$1.40 per 1,000 queries
Fast ($1.40) answers from headlines and standfirsts: good for screening a whole watchlist before reading.
An example month
200 tickers, checked 12 times a day for 22 trading days
52,800 queries in normal mode ≈ $116
List prices from our pricing page. Each query in a multi-query request counts as one search; identical requests within 10 minutes are free.
curl https://api.typesearch.ai/v1/search \-H "Authorization: Bearer $TYPESEARCH_API_KEY" \-H "Content-Type: application/json" \-d '{"query": ["Initech earnings guidance", "Initech acquisition"],"mode": "normal","days": 1,"max_results": 10,"questions": {"event": {"type": "choice","instructions": "What kind of event does the article report about Initech?","criteria": {"earnings": null,"guidance": null,"deal": "Merger, acquisition or divestiture.","regulation": null,"other": null}},"impact": {"type": "score","instructions": "How material is it for the company?","criteria": ["None", "Low", "Moderate", "High"]},"mentions_figure": {"type": "boolean","instructions": "Does the article give a specific number (revenue, price, amount)?"}}}'
What you get back
- Title, URL, source and publication time
- answers: your typed questions, answered per article, with basis: article when it was read
- score: the probability it is about your query
- highlights: verbatim excerpts of up to 25 words, on request
- Several queries per request, each result tagged with the query it answers
When to use something else
- You need prices, fundamentals or filings: we are a news index, not a market-data provider.
- You need tick-level latency or a licensed real-time wire: use a newswire feed.
- You need years of news history for backtesting: our index keeps a rolling 30 days.
One result, trimmed
{"title": "Initech raises full-year guidance after strong quarter","url": "https://financeweekly.example/markets/initech-guidance","source": "Finance Weekly","published_at": "2026-09-25T13:05:00Z","score": 0.97,"answers": {"basis": "article","values": {"event": { "type": "choice", "choice": "guidance", "confidence": 0.9 },"impact": { "type": "score", "score": 2.4, "confidence": 0.78 },"mentions_figure": { "type": "boolean", "probability": 0.95 }}}}
Questions
Is typesearch fast enough for trading?
For agents that decide in seconds or minutes, yes: results judged from the headline arrive about a second in, and each is confirmed as its article is read. For tick-level trading, use a licensed newswire.
Can I get sentiment for a stock?
tone: true returns positive, neutral or negative toward your query for every result. For finer signals, ask a typed question — for example a 1–5 score for impact on the company — and get it per article.
Which markets do you cover?
Business and general news from sources in more than 130 countries, starting with Latin America. Every result shows its source and links to the original. Missing an outlet? Suggest it from the dashboard (Suggest a source) or write to support@typesearch.ai.
What does it cost?
52,800 queries in normal mode ≈ $116 at list price. Screening in fast mode costs $1.40 per 1,000 queries.
Keep reading
Comparisons
Alternatives
Build it this afternoon.
Get a key with $5 in free credit, run the request above and see what comes back.