Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaFinanceAvailable now

Benzinga · News search

benzinga/news/search

Get market and financial data with Benzinga · News search from Alexandria through one Spiral API key. Use for what was reported about a company or subject, and when. Scope it to tickers or a date range: unscoped it returns the whole newswire. For the analyst reaction to a story use calendar/ratings. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

Pricing

$0.052377 per call.

Limits

Runs
In the background
Returns
json
Longest queue wait
1 hour
Run deadline
5 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
datetext—

A single day to query, yyyy-mm-dd. Use it instead of dateFrom and dateTo when the caller names one date.

isintext—

Comma-separated ISINs, maximum 50. Use it when the caller identifies companies by ISIN rather than ticker.

pagenumber
… to 100000
0

Page offset, limited to 0-100000. Increase it to read past the first page of results rather than widening the date range.

sortone of
id:asc, id:desc, created:asc, created:desc, updated:asc, updated:desc
—

Sort order as field:direction. Use created:asc to read a period forwards, or updated:desc when tracking edits.

cusipstext—

Comma-separated CUSIPs, maximum 50; requires a license agreement. Use only when the caller supplies CUSIPs.

dateTotext—

Latest publication date, yyyy-mm-dd. Pair it with dateFrom to bound a period.

formatone of
text
—

Desired response format. Set text only when you want plain text rather than the default JSON structures.

regiontext—

Region filter, for example 'ca' or 'canada' for Canadian content. Set it when the caller scopes the question to a market.

topicstext—

Comma-separated words or phrases matched against title, tags and body in that order of priority. Use it when the caller asks about a subject rather than a company.

authorstext—

Comma-separated authors. Set it to restrict to a particular desk or writer.

tickerstext—

Comma-separated ticker symbols, maximum 50. Set this whenever the caller names a company.

channelstext—

Comma-separated Benzinga channels to restrict to, for example Earnings or Analyst Ratings.

dateFromtext—

Earliest publication date, yyyy-mm-dd. Set it whenever the caller asks about a period rather than a single day.

pageSizenumber
… to 100
15

Stories to return, maximum 100. Raise it when you want a full day of coverage in one call.

importancetext—

Importance level filter. Set it when the caller only wants the market-moving stories.

updatedSincenumber—

Unix timestamp in UTC; set it to your last sync time to pull only stories updated since then.

content_typestext—

Comma-separated content types. Set it when you need to keep the feed to a specific content type.

displayOutputone of
full, abstract, headline
headline

How much of each story to return: headline only, abstract (headline plus teaser) or full body text. Set full only when you need to quote the story.

importanceRanknumber
1 to 5
—

Importance rank from 1 to 5. Set a low number to keep only the highest-ranked stories.

primaryTickerstext—

Comma-separated primary ticker symbols. Use it instead of tickers when you want only stories whose primary subject is that company.

publishedSincenumber—

Unix timestamp in UTC; set it to pull and sort by stories published since that moment.

topic_group_byone of
and, or
or

Logical operator for the topics query. Set and when every topic must appear, or leave as or to match any.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "benzinga/news/search",
    "input": {
      "date": "<date>"
    }
  }'

Frequently asked questions

How much does Benzinga · News search cost?

$0.052377 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Benzinga · News search through an API?

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "benzinga/news/search"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with Alexandria to use Benzinga · News search?

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

Can my AI agent use Benzinga · News search?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.