Skip to main content
GET
Spoken-web heat for one entity

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Entity id, ent_{n} or the numeric id. Merged ids follow their redirect.

Query Parameters

days
integer
default:30

Lookback window in days, 7 to 365. Default 30. The card counts mentions in that many days, and in as many days before them, as mentions_window and mentions_prior_window. Pass the window the rest of your answer uses.

Required range: 7 <= x <= 365
src
enum<string>

The surface making this call. The Arcmira MCP server sends mcp-tool so every unlock link in a gate attributes to the directory install. Omit from your own client.

Available options:
mcp-tool

Response

Success

entity
object
required
verdict
enum<string>
required

Absolute delta of the window against the prior window of the same length. The delta it needs grows with the square root of the window: 3 at 7 days, 5 at 30, 9 at 90, 18 at 365. none when the entity has no mentions at all.

Available options:
accelerating,
flat,
fading,
none
as_of
string | null
required

Newest indexed media that mentions the entity. Lead with it; it is the date the verdict is true as of.

window
object
required

The window mentions_window counts, [after, before) in UTC. mentions_prior_window counts the same number of days before after.

coverage
string
required

What the count measures. Always the shows we index, never the whole internet.

volume
object
required

Each count ends where window ends. On a plan whose freshness gate cut the window, nothing published after window.before is counted.

top_shows
object[]
required

Up to five channels by mentions in window.

note
string
required

One steering sentence for the agent reading this.

paid_vs_organic
object

Commercial split in window, by the classes GET /v1/recommendations uses: sponsored (an ad-style promotion heard at that moment: a paid sponsor read, promo code, affiliate plug, thanks for supplied goods or venue, or a show promoting its own product as an ad), organic (an unpaid personal recommendation), mention (a neutral commercial mention). Present only on a Pro+ plan; otherwise access names the gate.

access
object

The gate that reduced this response. Present only when something was withheld; carries the same code, gate, and unlock an outright refusal would.

freshness
object

Present when your plan's freshness gate cut the window: where results on this plan stop. unlock names the plan that reads past it.

unlock
object

Present with freshness when your plan's freshness gate cut the window; note says so.