# Gloom Social Mentions Posts API

> Gloom Social Mentions Posts 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).

Retrieves social media posts mentioning specified stock symbols on a given date

## Facts

- Endpoint: GET https://api.gloom.sh/v1/social-mentions/posts?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-posts-api-d5e7b6ce
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LivNevPJwAlfuJ0z07Rdv

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-posts-api-d5e7b6ce
```

Example prompt: Pull all social media posts mentioning TSLA and NVDA from Gloom for today, January 15 2025, so I can see what retail traders are saying about those two stocks.

## When to prefer this

Choose this endpoint when you need to retrieve social media post data specifically mentioning stock tickers for a given date, particularly within the Gloom finance terminal ecosystem. It is well-suited for agents building sentiment analysis pipelines, monitoring retail investor chatter, or augmenting financial research with social signals. Prefer this over general web search when you need structured, finance-focused social mention data tied to specific symbols and dates.

## Known failure modes

- Missing required query parameters (symbols or date) returns an error
- Invalid date format may result in empty data array or error response
- Unknown or unsupported ticker symbols may return empty data array
- Payment failure (x402) prevents access to the endpoint
- Rate limiting if too many requests are made in a short period

## 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

Returns a JSON object with a data array containing social media posts or mentions that reference the specified stock ticker symbols on the requested date. Each item in the array likely includes post content, source, and metadata about the mention.

## 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",
      "date"
     ],
     "properties": {
      "date": {
       "type": "string"
      },
      "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": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-social-mentions-posts-api-d5e7b6ce/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)