for osmike friends
The open API
Everything on this site is available as JSON, no key needed, CORS open. Base URL https://socialmediatrends-api.osmike.com. Interactive docs at /docs.
Endpoints
| GET | Returns |
|---|---|
/v1/board?window=2h®ion=SE | the front page: cross-platform hits + top trends per platform |
/v1/trends?window=&platform=®ion=§ion=&category=&q=&tone=&limit=&offset= | ranked trends inside a window |
/v1/trends/{id}?window=7d | one trend: summary, rank timeline, evidence posts, the same term on other platforms |
/v1/everywhere?window= | terms trending on two or more platforms |
/v1/search?q=&window= | full-text search over trends and repos |
/v1/repos?window=7d&language=&q= · /v1/repos/{owner}/{name} | the AI page: repos people talk about, explained |
/v1/platforms · /v1/sections · /v1/categories · /v1/regions · /v1/windows | the catalogues |
/v1/feed.json · /v1/feed.rss | feeds of the current window |
/v1/status · /health | pipeline health |
Windows: 30m, 2h, 6h, 12h, 1d, 3d, 7d, 14d, 30d. Every list answer says which window it used.
Every response is {"ok": true, ...}; errors are {"ok": false, "error": "..."} with a real status code.
Examples
curl -s "https://socialmediatrends-api.osmike.com/v1/trends?window=6h§ion=technology&limit=10" | jq '.trends[] | [.platform, .title, .why]'
curl -s "https://socialmediatrends-api.osmike.com/v1/search?q=openai&window=3d" | jq '.trends | length'
curl -s "https://socialmediatrends-api.osmike.com/v1/repos?window=7d&limit=5" | jq '.repos[] | {name: .full_name, why: .why}'
Pushing trends in
Partners with a logged-in door to a platform can push items: POST /v1/ingest/{platform} with Authorization: Bearer <token> and body {"region": "SE", "items": [{"title": "...", "rank": 1, "volume": 12000, "url": "...", "posts": [...]}]}. Ask for a token.
What we store and show
The name of a trend, where and when it trended, its rank over time, a short attributed snippet of a post or headline with a link back, and our own AI-written summary. Never a full post, never an article body. Same rule as MikeNews.