# Gloom Social Mentions API

> Gloom Social Mentions API is a paid API for AI agents from api.gloom.sh, paid per call via x402, $0.24/call, status unknown (last checked 2026-11-01).

Returns social media mention data (X/Twitter, Reddit, Wikipedia) for one or more stock ticker symbols over a specified time range

## Facts

- Endpoint: GET https://api.gloom.sh/v1/social-mentions?utm_source=zero.xyz
- Price: $0.24/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gloom-social-mentions-api-9ea1992b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WzDMsGzN_p8IyJEaYGJqC

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gloom-social-mentions-api-9ea1992b
```

Example prompt: Pull up the social mentions data for AAPL and TSLA from Gloom — I want to see their Reddit and Twitter mention history over the past year along with any top posts.

## When to prefer this

Choose this endpoint when you need structured, historical social media mention volume data specifically for stock tickers across X/Twitter, Reddit, and Wikipedia in one call. It is ideal for quantitative social signal analysis, detecting mention spikes, or enriching financial research with crowd sentiment proxies. Prefer it over general social listening tools when you need finance-specific, ticker-keyed data with baseline comparisons.

## Known failure modes

- Missing or invalid 'symbols' query parameter returns an error
- Unknown ticker symbols may return empty data arrays
- Rate limiting or payment failure (402) if USDC payment is not attached
- Data may be stale if refreshedAt timestamp is old
- completeThrough field may lag behind current date indicating incomplete recent data

## How this service works

Gloom is a free, open-source finance terminal for desktop and TUI with charts, news, filings, portfolios, alerts, and plugins.

## Output

A JSON array of objects, one per requested ticker symbol, each containing: X/Twitter daily mention counts with baseline and history range, Reddit daily mention counts with baseline, sentiment stance array, top posts, pending data, and Wikipedia article traffic with daily counts and article reference. All data is keyed by symbol with a range field indicating the time window covered.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "symbols"
     ],
     "properties": {
      "symbols": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "x": {
     "days": [],
     "baseline": null,
     "historyFrom": null,
     "refreshedAt": null,
     "completeThrough": null
    },
    "range": "1y",
    "reddit": {
     "days": [],
     "baseline": null
    },
    "stance": [],
    "symbol": "AAPL",
    "pending": [],
    "topPosts": [],
    "wikipedia": {
     "days": [],
     "article": null,
     "baseline": null
    }
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-social-mentions-api-9ea1992b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.gloom.sh](https://www.zero.xyz/host/api.gloom.sh/llms.txt)