# 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 handle without the @ 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 with volume

**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
}
```


---
Marketplace page: https://www.oanor.com/api/minds-api
OpenAPI spec: https://www.oanor.com/api/minds-api/openapi.json