v6 documentation is incomplete, want to contribute?

VRChat.community

API documentation, SDKs, and more
API Reference
Discord

List Favorited Avatars

Search and list favorited avatars by query filters.

Requests made through this page are proxied through an intermediary server due to Cross-Origin Resource Sharing restrictions.

GET
/avatars/favorites

Authorization

auth<token>

Auth Token via Cookie

In: cookie

Query Parameters

featured?boolean

Filters on featured results.

sort?string

The sort order of the results.

Default"popularity"
Value in"popularity" | "heat" | "trust" | "shuffle" | "random" | "favorites" | "reportScore" | "reportCount" | "publicationDate" | "labsPublicationDate" | "created" | "_created_at" | "updated" | "_updated_at" | "order" | "relevance" | "magic" | "name"
n?integer

The number of objects to return.

Default60
Range1 <= value <= 100
order?string

Result ordering

Default"descending"
Value in"ascending" | "descending"
offset?integer

A zero-based offset from the default object sorting from where search results start.

Range0 <= value
search?string

Filters by world name.

tag?string

Tags to include (comma-separated). Any of the tags needs to be present.

notag?string

Tags to exclude (comma-separated).

releaseStatus?string

Filter by ReleaseStatus.

Default"public"
Value in"public" | "private" | "hidden" | "all"
maxUnityVersion?string

The maximum Unity version supported by the asset.

minUnityVersion?string

The minimum Unity version supported by the asset.

platform?string

The platform the asset supports.

userId?string

Target user to see information on, admin-only.

Response Body

application/json

application/json

application/json

curl -X GET "https://api.vrchat.cloud/api/1/avatars/favorites?featured=true&sort=popularity&n=60&order=descending&offset=0&search=string&tag=string&notag=string&releaseStatus=public&maxUnityVersion=string&minUnityVersion=string&platform=string&userId=string"
[
  {
    "acknowledgements": "string",
    "assetUrl": "string",
    "assetUrlObject": {},
    "authorId": "usr_c1644b5b-3ca4-45b4-97c6-a2a0de70d469",
    "authorName": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "description": "string",
    "featured": false,
    "highestPrice": 0,
    "id": "avtr_912d66a4-4714-43b8-8407-7de2cafbf55b",
    "imageUrl": "string",
    "listingDate": "string",
    "lock": true,
    "lowestPrice": 0,
    "name": "string",
    "performance": {
      "android": "string",
      "android-sort": 0,
      "ios": "string",
      "ios-sort": 0,
      "standalonewindows": "string",
      "standalonewindows-sort": 0
    },
    "productId": "string",
    "publishedListings": [
      {
        "description": "string",
        "displayName": "string",
        "imageId": "string",
        "listingId": "string",
        "listingType": "string",
        "priceTokens": 0
      }
    ],
    "releaseStatus": "public",
    "searchable": false,
    "styles": {
      "primary": "string",
      "secondary": "string",
      "supplementary": [
        "string"
      ]
    },
    "tags": [
      "string"
    ],
    "thumbnailImageUrl": "string",
    "unityPackageUrl": "string",
    "unityPackageUrlObject": {
      "unityPackageUrl": "string"
    },
    "unityPackages": [
      {
        "id": "unp_52b12c39-4163-457d-a4a9-630e7aff1bff",
        "assetUrl": "https://api.vrchat.cloud/api/1/file/file_cd0caa7b-69ba-4715-8dfe-7d667a9d2537/65/file",
        "assetUrlObject": {},
        "assetVersion": 4,
        "created_at": "2020-09-10T06:13:27.777Z",
        "impostorizerVersion": "0.17.0",
        "performanceRating": "Excellent",
        "platform": "standalonewindows",
        "pluginUrl": "",
        "pluginUrlObject": {},
        "unitySortNumber": 20180414000,
        "unityVersion": "2022.3.6f1",
        "worldSignature": "AHiPAWerwCpeYrxDthF5TU2SdUWEWnm43UAn8PKRXlS8k8tVRQ==",
        "impostorUrl": "string",
        "scanStatus": "string",
        "variant": "string"
      }
    ],
    "updated_at": "2019-08-24T14:15:22Z",
    "version": 68
  }
]

{
  "error": {
    "message": "\"Missing Credentials\"",
    "status_code": 401
  }
}

{
  "error": {
    "message": "\\\"You can only see your own favorite avatars!\\\"",
    "status_code": 403
  }
}