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. GET /v1/sources shows the coverage by country and language, and whether a given outlet is covered.
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
Products
Build it this afternoon.
Get a key with $5 in free credit, run the request above and see what comes back.