Skip to content
unzoi docs
Search and navigation
Start here
REST API
MCP
Limits and plans
Agent clients
SDKs
Guides

Recipes / Catch funding rounds, acquisitions and IPOs

Catch funding rounds, acquisitions and IPOs

/stories in semantic mode. This page is the operational half — what comes back, how it breaks, and what running it for real takes.

The request

GET /stories
  ?q=raises funding round acquires acquisition stake IPO listing
  &mode=semantic
  &from=<now - 48h>

As a call you can paste:

curl -s -G "https://api.unzoi.com/stories" \
  -H "x-api-key: $UNZOI_KEY" \
  --data-urlencode "q=raises funding round acquires acquisition stake IPO listing" \
  --data-urlencode "mode=semantic" \
  --data-urlencode "from=<now - 48h>"

For an agent rather than a script, the same query is the list_stories MCP tool with these as its arguments.

Parameters used here

What comes back

Story clusters, typically the announcement plus trade pickup collapsed together.

Field by field: the /stories response reference.

How this goes wrong

Missing deals announced only in a local language. Add the languages matching the markets you care about — European and Asian deal coverage frequently never appears in English.

Adapting it

Adding a sector or geography filter turns this from a firehose into something readable, and both are usually more effective than adding vocabulary to the query. For deal tracking specifically, run a second pass a month later over the same window: the initial announcement and the completion are separate events, and the second is where terms are frequently revised.

Running it for real

A forty-eight-hour window polled every few hours is the right shape — deal news is announced rather than developed, so a short window catches it and a long one mostly re-delivers. Deduplicate on story identifier, since a single round is announced by the company, the lead investor and sometimes the bank, and all three get picked up separately. Expect quarter-end clustering and size the poll accordingly rather than being surprised by it.

Why this approach

The case for these parameters over the obvious alternatives — and when this recipe is the wrong tool entirely — is on the recipe's page on unzoi.com. It is kept there rather than repeated here, so the argument and the operations cannot drift apart.