Social mentions

One ticker day of public social mentions and observed article views.

One row is

One ticker day of public social mentions and observed article views

Example response

Trimmed real output. No key needed.

GET /v1/datasets/social-mentions/sample

Dates reflect the example, not current coverage.

{
  "data": {
    "symbol": "NVDA",
    "range": "1y",
    "asOf": "2026-10-04T01:00:00.000Z",
    "x": {
      "days": [],
      "historyFrom": null,
      "completeThrough": null,
      "baseline": null,
      "refreshedAt": null
    },
    "stance": [],
    "topPosts": [],
    "wikipedia": {
      "article": null,
      "days": [],
      "baseline": null
    },
    "reddit": {
      "days": [],
      "baseline": null
    },
    "pending": [],
    "warnings": [
      "Showing stored history; live refresh is paused for now"
    ]
  },
  "meta": {
    "dataset": "social-mentions",
    "asOf": null,
    "source": [
      {
        "id": "social-platforms",
        "attribution": "Public social and community activity",
        "licence": "Use subject to Gloom Datasets terms"
      }
    ],
    "historyStarts": null,
    "coverage": {
      "x": 0,
      "reddit": 0,
      "wikipedia": 0
    },
    "lastUpdated": null,
    "disclaimer": "Mentions measure public activity, not investment recommendations. Reads never trigger collection."
  }
}

Routes

Base URL https://api.gloom.sh. Send a key with each call; the key's account needs a plan.

GET /v1/social-mentions/{symbol}/history2 credits

Stored daily social mentions and public article views. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameter: symbol
In: path, required
Type: string ^[A-Za-z0-9.:-]{1,32}$
Notes: Company symbol; normalized to uppercase.

Parameter: limit
In: query
Type: integer 1 to 200

Parameter: offset
In: query
Type: integer 0 to 500000

Parameter: range
In: query
Type: 1y, 5y, max

Parameter	In	Type	Notes
`symbol`	path, required	string `^[A-Za-z0-9.:-]{1,32}$`	Company symbol; normalized to uppercase.
`limit`	query	integer 1 to 200
`offset`	query	integer 0 to 500000
`range`	query	`1y`, `5y`, `max`

Credits: 2 (history x1)
Plans: Basic, Desk, Enterprise

GET /v1/social-mentions/{symbol}/posts2 credits

Stored public posts mentioning a company ticker. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameter: symbol
In: path, required
Type: string ^[A-Za-z0-9.:-]{1,32}$
Notes: Company symbol; normalized to uppercase.

Parameter: limit
In: query
Type: integer 1 to 200

Parameter: offset
In: query
Type: integer 0 to 500000

Parameter: day
In: query, required
Type: date, YYYY-MM-DD
Notes: Valid calendar date (YYYY-MM-DD). from must be on or before to.

Parameter	In	Type	Notes
`symbol`	path, required	string `^[A-Za-z0-9.:-]{1,32}$`	Company symbol; normalized to uppercase.
`limit`	query	integer 1 to 200
`offset`	query	integer 0 to 500000
`day`	query, required	date, `YYYY-MM-DD`	Valid calendar date (YYYY-MM-DD). from must be on or before to.

Credits: 2 (search x1)
Plans: Basic, Desk, Enterprise

Meta fields

Field: dataset
Here: The dataset id
In the example: "social-mentions"

Field: asOf
Here: The observation date established by the service; otherwise null
In the example: null

Field: source
Here: Attribution and usage terms of each source
In the example: 1 source

Field: historyStarts
Here: Earliest stored history when established by the service; otherwise null.
In the example: null, not stated yet

Field: coverage
Here: Service-established coverage; null when unavailable.
In the example: {"x":0,"reddit":0,"wikipedia":0}

Field: lastUpdated
Here: The source update time established by the service; otherwise null
In the example: null

Field	Here	In the example
`dataset`	The dataset id	`"social-mentions"`
`asOf`	The observation date established by the service; otherwise null	null
`source`	Attribution and usage terms of each source	1 source
`historyStarts`	Earliest stored history when established by the service; otherwise null.	null, not stated yet
`coverage`	Service-established coverage; null when unavailable.	`{"x":0,"reddit":0,"wikipedia":0}`
`lastUpdated`	The source update time established by the service; otherwise null	null

Sources

Source: Public social and community activity
Usage terms: Use subject to Gloom Datasets terms

Source	Usage terms
Public social and community activity	Use subject to Gloom Datasets terms

Errors

These routes can answer 400, 401, 402, 403, 404, 429, 503. See Errors for the codes.

Gloom Datasets reads stored data only: a call never starts a collection.