---
title: "GET /users/search"
method: GET
path: "/users/search"
tags: ["users"]
---

# GET /users/search

`GET /users/search`

Search for users that match the given query

## Query parameters

- `offset` integer
- `limit` integer
- `query` string
- `genre` string[]
- `sort_method` 'relevant' | 'popular' | 'recent'
- `is_verified` string

## Response `200`

Success

- UserSearch
  - `data` User[]
    - `album_count` integer, required
    - `artist_pick_track_id` string
    - `artist_coin_badge` object, required
      - `mint` string
      - `logo_uri` string
      - `banner_image_url` string
      - `ticker` string — The coin symbol/ticker
    - `coin_flair_mint` string
    - `bio` string
    - `cover_photo` CoverPhoto
      - `640x` string
      - `2000x` string
      - `mirrors` string[]
    - `followee_count` integer, required
    - `follower_count` integer, required
    - `handle` string, required
    - `id` string, required
    - `is_verified` boolean, required
    - `twitter_handle` string
    - `instagram_handle` string
    - `tiktok_handle` string
    - `verified_with_twitter` boolean, required
    - `verified_with_instagram` boolean, required
    - `verified_with_tiktok` boolean, required
    - `website` string
    - `donation` string
    - `location` string
    - `name` string, required
    - `playlist_count` integer, required
    - `profile_picture` ProfilePicture
      - `150x150` string
      - `480x480` string
      - `1000x1000` string
      - `mirrors` string[]
    - `repost_count` integer, required
    - `track_count` integer, required
    - `is_deactivated` boolean, required
    - `is_available` boolean, required
    - `erc_wallet` string, required
    - `spl_wallet` string, required
    - `spl_usdc_wallet` string, required
    - `spl_usdc_payout_wallet` string
    - `supporter_count` integer, required
    - `supporting_count` integer, required
    - `total_audio_balance` integer, required
    - `wallet` string, required — The user's Ethereum wallet address for their account
    - `balance` string, required
    - `associated_wallets_balance` string, required
    - `total_balance` string, required
    - `waudio_balance` string, required
    - `associated_sol_wallets_balance` string, required
    - `blocknumber` integer, required
    - `created_at` string, required
    - `is_storage_v2` boolean, required
    - `creator_node_endpoint` string
    - `current_user_followee_follow_count` integer, required
    - `does_current_user_follow` boolean, required
    - `does_current_user_subscribe` boolean, required
    - `does_follow_current_user` boolean, required
    - `handle_lc` string, required
    - `updated_at` string, required
    - `cover_photo_sizes` string
    - `cover_photo_cids` CoverPhoto
      - `640x` string
      - `2000x` string
      - `mirrors` string[]
    - `cover_photo_legacy` string
    - `profile_picture_sizes` string
    - `profile_picture_cids` ProfilePicture
      - `150x150` string
      - `480x480` string
      - `1000x1000` string
      - `mirrors` string[]
    - `profile_picture_legacy` string
    - `has_collectibles` boolean, required
    - `playlist_library` PlaylistLibrary
      - `contents` object[]
    - `allow_ai_attribution` boolean, required
    - `profile_type` string

## Other responses

- `400` — Bad request
- `500` — Server error

---

[API](https://skmtc.dev/audius/apis/audius-api.md) · [All operations](https://skmtc.dev/audius/apis/audius-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/audius/audius-api/revisions/940230b2ed3d/schema)