Submit avatars

Submit one ID or a batch through the public API.

Send one avatar ID or VRChat avatar URL, or batch up to 50 in an avatarIds array. No account or API key is needed. AviSeek fetches the metadata and checks privacy before listing it; submission does not claim ownership.

100 submitted items per minute per IP, including invalid and duplicate IDs. Batch up to 50 IDs in one request with avatarIds. Each entry counts toward the limit. On HTTP 429, wait for the number of seconds in the Retry-After header.

POST https://aviseek.vrchatlegends.com/api/avatars/submit
Content-Type: application/json

{
  "avatarId": "avtr_00000000-1111-2222-3333-444444444444"
}

Batches return accepted and rejected counts plus ordered results for every ID. Check each status and code. The queue holds 1,000 pending avatars; retry queue_full items later. Single submissions receive HTTP 503 if full. Accepted avatars are verified by the paced worker.

{
  "avatarIds": [
    "avtr_00000000-1111-2222-3333-444444444444",
    "avtr_11111111-2222-3333-4444-555555555555"
  ]
}

Download batch JSON · Download example JSON

Replace the example ID with a real avatar ID. 200: single item queued or batch processed; inspect each batch result. 400: invalid input. 403: blocked avatar. 409: already indexed or queued. 429: rate limit reached. Queue processing is paced separately from submissions.