Skip to content
GET /v1/search-users

Find members by name or handle

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/misskey-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/misskey-api/v1/search-users" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/misskey-api/v1/search-users", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/misskey-api/v1/search-users");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/misskey-api/v1/search-users",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "count": 10,
        "query": "art",
        "users": [
            {
                "id": "97cs2jb212",
                "url": "https://misskey.io/@ni_artificial",
                "host": null,
                "name": "にぁー",
                "notes": 20169,
                "handle": "@ni_artificial",
                "is_bot": false,
                "is_cat": true,
                "username": "ni_artificial",
                "followers": 0,
                "following": 0,
                "avatar_url": "https://proxy.misskeyusercontent.jp/avatar.webp?url=https%3A%2F%2Fmedia.misskeyusercontent.jp%2Fmisskey%2Fbbf195d8-8285-42c0-a659-baad2b70ddf5.png&avatar=1",
                "created_at": "2022-11-09T05:41:34.910Z",
                "description": "ねん撮り愛好家:blobcatmeltlove:\n風景写真とかも撮ってます\n#ねんどろいど #figma #ねんどろいどどーる"
            },
            {
                "id": "a0n4z5w3ymsn01v5",
                "url": "https://takusuki.com/@senata",
                "host": "takusuki.com",
                "name": ":scenario::ablobartist:せな汰:ts::syo:",
                "notes": 46136,
                "handle": "@[email protected]",
                "is_bot": false,
                "is_cat": false,
                "username": "senata",
                "followers": 0,
                "following": 0,
                "avatar_url": "https://proxy.misskeyusercontent.jp/avatar/083.takusuki.com%2Fhouse%2Fshell02%2F4b19f026-3366-4835-80c1-493fe2fb734c.webp?avatar=1",
                "created_at": "2024-11-16T02:52:02.067Z",
                "description": ":shinobigami::daisuki::rok::gabazei:\nエアリプしたり色々やかましいので(ノート数参照)、フォローやフォロバやフォロー解除はお気軽に:inuouen:\n\n基本:yoru::ts:(21:00-24:00)\nGMするのが好き\nPLは誘われたりしたらやります\n\n20↑\n生年は「よだかの星」発表年だよ。\n\n持ってるシステム\n\n〇既プレイ\nCoC6版、シノビガミ、マギカロギア、デッドラインヒーローズ、ブラックジャケット、ダブルクロス3rd、銀剣のステラナイツ、アンサング・デュエット、ストリテラ、ウタカゼ、ログ・ホライズン、ネクロニカ、フタリソウサ、SW2.5(Ⅰ,Ⅱ)、インセイン、エモクロア\n\n〇未プレイ\nモノトーンミュージアム、サタスペ、ブラドリウム、ココロダンジョン、CoC7版、歯車の塔の探空士\n\n〇その他\nおまじな大饗宴、おまじなSOS"
            },
            {
                "id": "9xixgyv8a37k02sj",
                "url": "https://misskey.flowers/@tartarowers",
                "host": "misskey.flowers",
                "name": "藻",
                "notes": 14334,
                "handle": "@[email protected]",
                "is_bot": false,
                "is_cat": false,
                "username": "tartarowers",
                "followers": 9,
                "following": 13,
                "avatar_url": "https://proxy.misskeyusercontent.jp/avatar/s3.misskeyflowersusercontent.jp%2Fmedia%2Fd75fe79c-c360-4298-801e-5383802e0ebd.webp?avatar=1",
                "created_at": "2024-08-29T14:11:44.132Z",
                "description": "善人です\n少なくとも悪い人間では無いです\n信じてください"
            },
            {
                "id": "ab5knyqzk1540h86",
                "url": "https://misskey.flowers/@bowbowparty",
                "host": "misskey.flowers",
                "name": "bowbowparty",
                "notes": 16455,
 
…