# Minds API > Read any public Minds channel and the platform's live hashtag trends — no key needed. Minds is an open-source, decentralised social network; this API returns a public channel's display name, bio, subscriber and subscription counts, lifetime impressions, Plus/Pro and verified flags and join date, plus the hashtags trending on Minds right now with their volume. Pass a username (the handle without the @). Data comes live from Minds' own public API — nothing cached, nothing stored. Distinct from the Mastodon/fediverse APIs — Minds runs its own platform. Built for social dashboards, creator analytics and trend monitoring. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/minds-api/..." ``` ## Pricing - **Free** (Free) — 26,500 calls/Mo, 3 req/s - **Starter** ($6/Mo) — 345,000 calls/Mo, 10 req/s - **Pro** ($18/Mo) — 1,460,000 calls/Mo, 25 req/s - **Scale** ($44/Mo) — 5,050,000 calls/Mo, 50 req/s ## Endpoints ### Channel #### `GET /v1/channel` — Public channel/profile and engagement stats **Parameters:** - `username` (query, required, string) — Minds channel handle (no @) Example: `ottman` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/minds-api/v1/channel?username=ottman" ``` **Response:** ```json { "data": { "bio": "Co-creator & CEO @minds ", "pro": true, "guid": "100000000000000341", "name": "Bill Ottman", "plus": true, "joined": "2012-10-01T15:47:15.000Z", "source": "Minds", "username": "ottman", "verified": true, "impressions": 30433356, "subscribers": 156404, "subscriptions": 327 }, "meta": { "timestamp": "2026-06-11T16:47:29.956Z", "request_id": "787ab193-a550-4192-ad2b-f2425ab47735" }, "status": "ok", "message": "Channel retrieved successfully", "success": true } ``` ### Trends #### `GET /v1/trends` — Hashtags trending on Minds right now **Parameters:** - `limit` (query, optional, string) — Max results (1-50) Example: `10` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/minds-api/v1/trends?limit=10" ``` **Response:** ```json { "data": { "count": 2, "source": "Minds", "trends": [ { "volume": 2, "hashtag": "gemma", "selected": null }, { "volume": 15, "hashtag": "faggottourney", "selected": null } ] }, "meta": { "timestamp": "2026-06-11T16:47:31.123Z", "request_id": "4388e0d6-2a80-430c-8e09-5487ae8d8b8c" }, "status": "ok", "message": "Trends retrieved successfully", "success": true } ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/minds-api/v1/meta" ``` **Response:** ```json { "data": { "note": "Usernames are Minds channel handles without the @ (e.g. ottman, minds). subscribers/subscriptions are live counts; impressions is the channel's lifetime impression count; joined is the channel creation date.", "source": "Minds public API (minds.com/api, live)", "service": "minds-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/trends": "Hashtags trending on Minds right now, with volume (limit=10, max 50).", "GET /v1/channel": "Public channel/profile and engagement stats for a handle (username=ottman)." }, "description": "Live public data from Minds, an open-source decentralised social network. The channel endpoint returns a public channel/profile and its engagement stats (display name, bio, subscriber and subscription counts, lifetime impressions, plus/pro flags and join date); the trends endpoint returns the hashtags trending on Minds right now with their volume. Live, no key, nothing stored. A genuine decentralised-social feed (channels, stats and hashtag trends), distinct from the Mastodon/fediverse and the other social APIs in the catalogue.", "trend_sample": 9, "upstream_status": "ok" }, "meta": { "timestamp": "2026-06-11T16:47:32.395Z", "request_id": "3d88ab68-cbd1-4292-9098-ef05fdbd9e0b" }, "status": "ok", "message": "Meta", "success": true } ``` ### Channels #### `GET /v1/feed` — A channel's recent posts with engagement **Parameters:** - `username` (query, required, string) — Minds channel handle (no @) Example: `ottman` - `limit` (query, optional, string) — Max posts (1-50) Example: `12` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/minds-api/v1/feed?username=ottman&limit=12" ``` **Response:** ```json { "data": { "count": 12, "posts": [ { "url": "https://www.minds.com/newsfeed/1911292853681438720", "guid": "1911292853681438720", "owner": "ottman", "title": null, "message": "retrospective compression: the transformation of a complex process into a seemingly obvious turning point once the ending is known. It's one reason why history often appears to move in giant leaps even though it was usually experienced as a slow crawl.", "reminds": 2, "comments": 22, "thumbs_up": 35, "created_at": "2026-06-10T03:55:26.000Z", "thumbs_down": 0 }, { "url": "https://www.minds.com/newsfeed/1906760546045136896", "guid": "1906760546045136896", "owner": "ottman", "title": null, "message": "The Internet is currently in a pull to centralize with the temptation of AI and the amazing features it offers. \n\nDecentralized networks have always and will always struggle to compete. Private AI is much harder as well.\n\nDon't give up. Freedom requires patience and effort. ", "reminds": 12, "comments": 53, "thumbs_up": 99, "created_at": "2026-05-28T15:45:40.000Z", "thumbs_down": 0 }, { "url": "ht …(truncated, see openapi.json for full schema) ``` ### Discovery #### `GET /v1/search` — Search Minds posts by keyword **Parameters:** - `q` (query, required, string) — Search query Example: `bitcoin` - `sort` (query, optional, string) — latest (default) or top Example: `latest` - `limit` (query, optional, string) — Max results (1-50) Example: `12` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/minds-api/v1/search?q=bitcoin&sort=latest&limit=12" ``` **Response:** ```json { "data": { "sort": "latest", "count": 12, "query": "bitcoin", "source": "Minds", "results": [ { "url": "https://www.minds.com/newsfeed/1912524761032822784", "guid": "1912524761032822784", "owner": "cryptomaniaclothing", "title": null, "message": "Crypto-inspired apparel for Bitcoin, Ethereum & Web3 holders. 1,400+ original designs — hoodies, tees, caps, mugs and more. Ships worldwide. #Bitcoin #Crypto #Web3 #Ethereum https://cryptomaniaclothing.com", "reminds": 0, "comments": 0, "thumbs_up": 0, "created_at": "2026-06-13T13:30:36.000Z", "thumbs_down": 0 }, { "url": "https://www.minds.com/newsfeed/1912491670356627456", "guid": "1912491670356627456", "owner": "crypto24huk", "title": "Crypto ETF Investments Continue Breaking Records", "message": "\nOne major reason behind this market rally is the sharp increase in crypto ETF investments.\n\nVisit here : https://cryptodatabusiness.com/\n\nRecent reports show more than $532 million entering crypto ETF products within only a few days. Institutional investors are increasingly viewing digital assets as long-term investments instead of short-term trading opportunities.\n\nKey developments include:\n\nBitcoin ETF assets …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/minds-api OpenAPI spec: https://www.oanor.com/api/minds-api/openapi.json