Entities

Spoken-web heat for one entity

Mentions in the last 7 and 30 days against the prior 30, an absolute-delta verdict (accelerating, flat, fading, none), the newest media date, and the top shows in the window. It counts the shows we index, not the whole internet, and it is a count, not a score. On a Pro+ plan the card also carries paid_vs_organic; otherwise that field is absent and access names the gate. Free; uses no credits. Every gate is a typed error whose error.unlock.url names the plan that lifts it; pass src=mcp-tool only from the Arcmira MCP server.

get/v1/entities/{id}/momentum

Request

Base URL: https://api.arcmira.com
URL: https://api.arcmira.com/v1/entities/{id}/momentum
Auth: HTTP bearer

Path parameters

idstring required

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

Query parameters

src'mcp-tool'

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.

Response

Success

verdict'accelerating' | 'flat' | 'fading' | 'none' required

Absolute delta of the last 30 days against the prior 30. none when the entity has no mentions at all.

as_ofstring nullable required

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

coveragestring required

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

notestring required

One steering sentence for the agent reading this.

Example response

{
  "entity": {
    "id": "ent_14",
    "name": "Ramp",
    "type": "organization",
    "slug": "ramp",
    "page": "https://arcmira.com/org/ramp"
  },
  "verdict": "accelerating",
  "as_of": "2026-08-28T17:00:00.000Z",
  "coverage": "Shows we index, not the whole internet.",
  "volume": {
    "mentions_7d": 6,
    "mentions_30d": 23,
    "mentions_prior_30d": 11,
    "delta_30d_absolute": 12,
    "delta_30d_pct": 109.1,
    "mentions_90d": 41,
    "total": 188
  },
  "top_shows": [
    {
      "channel_id": "UC-DRzaGnL_vtBUpCFH5M0tg",
      "channel_name": "TBPN",
      "channel_page": "https://arcmira.com/yt/@TBPNLive",
      "mentions": 17
    },
    {
      "channel_id": "UClWkDGXEzsh77GAhs90wpXw",
      "channel_name": "Moment of Truth",
      "channel_page": "https://arcmira.com/yt/@MomentofTruthShow",
      "mentions": 3
    }
  ],
  "access": {
    "type": "permission_error",
    "code": "recommendations_not_enabled",
    "message": "The paid versus organic split requires Pro+. Open unlock.url to start Pro+.",
    "gate": "plan",
    "resource": {
      "kind": "commercial",
      "what": "paid_split"
    },
    "unlock": {
      "tier": "pro_plus",
      "url": "https://arcmira.com/pricing?src=mcp-tool",
      "offer": null
    },
    "doc_url": "https://arcmira.com/docs/errors#recommendations_not_enabled",
    "request_id": "req_7f3c2a"
  },
  "note": "Lead with verdict and as_of. Then volume and shows. The paid vs organic split needs a plan that carries it; card.access says so. Search transcripts second for quotes. Never invent a heat score."
}

Changes

No recorded changes to this operation across all 1 revision of this API.