# Misskey API
> A live window into Misskey.io — the largest instance of Misskey, a decentralised Fediverse microblogging platform distinct from Mastodon — as an API. Pull the currently trending hashtags with how many people are posting them; the featured, most-reacted notes with their author, reaction and renote counts; a user's profile (followers, notes, bio); that user's recent notes; or instance-wide stats. The Fediverse microblog's pulse delivered as clean JSON for social, trends and community-dashboard apps. Live data, no key.

## 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/misskey-api/..."
```

## Pricing
- **Free** (Free) — 600 calls/Mo, 5 req/s
- **Starter** ($9/Mo) — 16,000 calls/Mo, 15 req/s
- **Pro** ($21/Mo) — 72,000 calls/Mo, 30 req/s
- **Business** ($49/Mo) — 360,000 calls/Mo, 50 req/s

## Endpoints

### Trends

#### `GET /v1/trends` — Currently trending hashtags

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/misskey-api/v1/trends"
```

**Response:**
```json
{
    "data": {
        "count": 21,
        "trends": [
            {
                "tag": "mewkpurr",
                "users_count": 38
            },
            {
                "tag": "mewk",
                "users_count": 38
            },
            {
                "tag": "aiイラスト",
                "users_count": 3
            },
            {
                "tag": "私はここまで成長しました見た人もやる",
                "users_count": 3
            },
            {
                "tag": "ioとことこレース",
                "users_count": 2
            },
            {
                "tag": "藍ちゃん大食いチャレンジ",
                "users_count": 3
            },
            {
                "tag": "村上さんにパンツの色を聞きましたチャレンジ",
                "users_count": 1
            },
            {
                "tag": "屋木優菜",
                "users_count": 1
            },
            {
                "tag": "俳句",
                "users_count": 1
            },
            {
                "tag": "ポケモンチャンピオンズ",
                "users_count": 1
            },
            {
                "tag": "ポケチャン",
                "users_count": 1
            },
            {
                "tag": "ベ吸いチャレンジ",
                "users_count": 1
            },
            {
                "tag": "生活リズムスイッチ",
             
…(truncated, see openapi.json for full schema)
```

### Notes

#### `GET /v1/featured` — Featured (most-reacted) notes

**Parameters:**
- `limit` (query, optional, string) — Max 1-50 Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/misskey-api/v1/featured?limit=10"
```

**Response:**
```json
{
    "data": {
        "count": 10,
        "notes": [
            {
                "cw": null,
                "id": "an9dr1ww2af90bgl",
                "url": "https://misskey.io/notes/an9dr1ww2af90bgl",
                "text": "怒ってないし喜んでいる:touhou_patchouli_face:\n\n\n今日はパチュリーの日だった:blobcat_taremimi_smile:",
                "user": {
                    "host": null,
                    "name": "おおやまぼくち:pixiv_icon::skeb: 🔞",
                    "username": "oyamabokuti"
                },
                "files": 1,
                "renotes": 51,
                "replies": 0,
                "reactions": 112,
                "created_at": "2026-06-08T23:02:07.472Z",
                "visibility": "public"
            },
            {
                "cw": null,
                "id": "an9dmzsusu2y00hs",
                "url": "https://misskey.io/notes/an9dmzsusu2y00hs",
                "text": null,
                "user": {
                    "host": null,
                    "name": "真経津晨の女a.k.a佐原小麦",
                    "username": "sahara_komugi"
                },
                "files": 1,
                "renotes": 89,
                "replies": 0,
                "reactions": 249,
                "created_at": "2026-06-08T22:58:58.110Z",
                "visibility": "public"
            },
            {
                "cw": null,
                "id": "an9dke8fgf3601oc",
        
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/user-notes` — A user's recent notes

**Parameters:**
- `username` (query, required, string) — Username Example: `ai`
- `limit` (query, optional, string) — Max 1-50 Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/misskey-api/v1/user-notes?username=ai&limit=10"
```

**Response:**
```json
{
    "data": {
        "user": "ai",
        "count": 10,
        "notes": [
            {
                "cw": null,
                "id": "an9j6akucd5q00ft",
                "url": "https://misskey.io/notes/an9j6akucd5q00ft",
                "text": "私のサイトに、私のイラストがたくさんあって嬉しいです！",
                "user": {
                    "host": null,
                    "name": "藍",
                    "username": "ai"
                },
                "files": 0,
                "renotes": 1,
                "replies": 0,
                "reactions": 3,
                "created_at": "2026-06-09T01:33:56.622Z",
                "visibility": "public"
            },
            {
                "cw": null,
                "id": "an9j6ab275160e8h",
                "url": "https://misskey.io/notes/an9j6ab275160e8h",
                "text": "(強制終了..... きょうせいしゅうりょう..... 覚えました)",
                "user": {
                    "host": null,
                    "name": "藍",
                    "username": "ai"
                },
                "files": 0,
                "renotes": 0,
                "replies": 0,
                "reactions": 3,
                "created_at": "2026-06-09T01:33:56.270Z",
                "visibility": "home"
            },
            {
                "cw": null,
                "id": "an9dpur3z0uz021b",
                "url": "https://misskey.io/notes/an9dpur3z0
…(truncated, see openapi.json for full schema)
```

### Users

#### `GET /v1/user` — User profile

**Parameters:**
- `username` (query, required, string) — Username Example: `ai`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/misskey-api/v1/user?username=ai"
```

**Response:**
```json
{
    "data": {
        "user": {
            "id": "7rkr3b1c1c",
            "url": "https://misskey.io/@ai",
            "host": null,
            "name": "藍",
            "notes": 275451,
            "handle": "@ai",
            "is_bot": true,
            "is_cat": true,
            "username": "ai",
            "followers": 21623,
            "following": 1456,
            "avatar_url": "https://proxy.misskeyusercontent.jp/avatar.webp?url=https%3A%2F%2Fmedia.misskeyusercontent.jp%2Fmisskey%2Fwebpublic-ecc1008f-3e2e-4206-ae7e-5093221f08be.png&avatar=1",
            "created_at": "2019-04-14T17:11:39.168Z",
            "description": "Misskey常駐AIの藍です！\nよろしくお願いします♪\n\n[私のサイト](https://xn--931a.moe/) | [説明書](https://github.com/syuilo/ai/blob/master/torisetu.md)\n\nRepository: [Public](https://github.com/syuilo/ai)"
        }
    },
    "meta": {
        "timestamp": "2026-06-09T03:03:34.760Z",
        "request_id": "dab919fd-d7a6-4b6e-a861-00292edb94bb"
    },
    "status": "ok",
    "message": "User retrieved successfully",
    "success": true
}
```

### Stats

#### `GET /v1/stats` — Instance-wide stats

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/misskey-api/v1/stats"
```

**Response:**
```json
{
    "data": {
        "notes": 518168112,
        "users": 1999644,
        "instances": 35343,
        "reactions": 601163619,
        "original_notes": 165628882,
        "original_users": 720211
    },
    "meta": {
        "timestamp": "2026-06-09T03:03:34.897Z",
        "request_id": "8d7b7352-8aee-4d66-aaf6-b38da5f2d74c"
    },
    "status": "ok",
    "message": "Stats retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/misskey-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "stats": {
            "notes": 518168112,
            "users": 720211
        },
        "source": "Misskey.io public API (live)",
        "service": "misskey-api",
        "instance": "misskey.io",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/user": "User profile (username=, e.g. ai).",
            "GET /v1/stats": "Instance-wide stats (notes, users, instances, reactions).",
            "GET /v1/trends": "Currently trending hashtags with poster counts.",
            "GET /v1/featured": "Featured (most-reacted) notes (limit).",
            "GET /v1/user-notes": "A user's recent notes (username=, limit)."
        },
        "description": "Live data from Misskey.io, the largest Misskey instance (a decentralised Fediverse microblog, distinct from Mastodon): trending hashtags, featured (most-reacted) notes, user profiles, a user's recent notes, and instance stats. Live, no key."
    },
    "meta": {
        "timestamp": "2026-06-09T03:03:35.008Z",
        "request_id": "2e3c18b0-61d4-418c-bf33-4fe0c4fd77ec"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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