Social Entropy
The Social Entropy API takes 5 Reddit sources (subreddits or users) and produces a number 0-99 derived from each source's latest hot post — its upvotes, comments, age, and title length, hashed together. Each call also returns the contributing posts, a methodology note, and a short Haiku-written analysis explaining why this number was inevitable. We wanted to use Instagram. Instagram did not want us to use Instagram.
Try It — No Seriously
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
sources |
string |
Optional | technology,worldnews,science,programming,showerthoughts |
Comma-separated list of up to 5 subreddits or users (e.g. "technology,worldnews,u/spez"). Defaults to 5 popular subreddits. |
Examples
curl "https://api.stupidapis.com/social-entropy/generate?sources=technology,worldnews,programming"
import requests
response = requests.get(
"https://api.stupidapis.com/social-entropy/generate",
params={"sources": "technology,worldnews,programming"}
)
print(response.json())
const response = await fetch( "https://api.stupidapis.com/social-entropy/generate?sources=technology,worldnews,programming" ); const data = await response.json(); console.log(data);
Response Schema
| Field | Type | Description |
|---|---|---|
number |
number |
The generated number 0-99 |
methodology |
string |
How the number was derived |
sources |
object[] |
Per-source contributions (title, score, comments, age, entropy) |
failed_sources conditional |
string[] |
Sources that did not respond |
total_entropy |
number |
Sum of all entropy contributions |
analysis |
string |
Haiku-written explanation of the number |
platform |
string |
Always reddit |
platform_note |
string |
Why not Instagram |
sources_consulted |
number |
Number of sources successfully fetched |
sources_that_cooperated |
number |
Number of cooperating sources |
generated_at |
string |
ISO timestamp |
Example Response
{
"number": 47,
"methodology": "Latest posts from 5 Reddit sources. Upvotes, comments, age, and title length hashed into a two-digit number. Peer reviewed by nobody.",
"sources": [
{
"source": "r/technology",
"title": "New chip design promises 30% efficiency gains",
"score": 4827,
"comments": 312,
"age_hours": 6,
"title_length": 47,
"entropy_contribution": 92
},
{
"source": "r/worldnews",
"title": "Officials report progress on long-running negotiations",
"score": 1284,
"comments": 89,
"age_hours": 12,
"title_length": 56,
"entropy_contribution": 41
},
{
"source": "r/programming",
"title": "Refactoring legacy code: a five-part series",
"score": 892,
"comments": 144,
"age_hours": 18,
"title_length": 43,
"entropy_contribution": 97
}
],
"total_entropy": 230,
"analysis": "The technology post dominated with high recency and engagement, anchoring the number high. The worldnews post pulled it back to a more moderate range. The number 47 was inevitable: a compromise between recency and reach.",
"platform": "reddit",
"platform_note": "We wanted to use Instagram. Instagram did not want us to use Instagram.",
"sources_consulted": 3,
"sources_that_cooperated": 3,
"generated_at": "2026-05-06T18: 50: 00.000Z"
}
MCP Access
This API is available as an MCP tool for AI assistants. Connect your agent to:
POST https://api.stupidapis.com/social-entropy/mcp
POST https://api.stupidapis.com/mcp
Use Pipeworx to connect this MCP tool to Claude, ChatGPT, and other AI assistants with no code.
