---
title: "GetSocialVelocity"
method: GET
path: "/api/intelligence/v1/get-social-velocity"
tags: ["IntelligenceService"]
---

# GetSocialVelocity

`GET /api/intelligence/v1/get-social-velocity`

## Request

- Base URL: `https://api.worldmonitor.app`
- URL: `https://api.worldmonitor.app/api/intelligence/v1/get-social-velocity`
- Auth: one of:
  - API key in header `X-WorldMonitor-Key`
  - API key in header `X-Api-Key`

GetSocialVelocity returns trending Reddit posts from r/worldnews and r/geopolitics ranked by velocity.

## Query parameters

- `jmespath` string

## Response `200`

OK

- WorldmonitorIntelligenceV1GetSocialVelocityResponse
  - `posts` WorldmonitorIntelligenceV1SocialVelocityPost[]
    - `id` string: Reddit post ID.
    - `title` string: Post title.
    - `subreddit` string: Subreddit name (without r/ prefix).
    - `url` string: Direct URL to the post.
    - `score` integer: Reddit score (upvotes - downvotes).
    - `upvoteRatio` number, double: Upvote ratio (0.0–1.0).
    - `numComments` integer: Number of comments.
    - `velocityScore` number, double: Composite velocity score accounting for recency, score, and ratio.
    - `createdAt` integer: Warning: Values > 2^53 may lose precision in JavaScript
  - `fetchedAt` integer: Warning: Values > 2^53 may lose precision in JavaScript

## Other responses

- `400`: Validation error
- `401`: Missing or invalid API key.
- `403`: API access requires an active subscription (the API key's subscription is inactive or expired).
- `429`: Rate limit exceeded.
- `503`: Service unavailable. Billing-verification responses include code and X-Billing-Verification; other gateway infrastructure failures use the generic GatewayError shape.
- `default`: Gateway or handler error response.

---

[API](https://skmtc.dev/worldmonitor/apis/worldmonitor-api.md) · [All operations](https://skmtc.dev/worldmonitor/apis/worldmonitor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/worldmonitor/apis/worldmonitor-api/revisions/e3dc8463a5c9?raw)