Catalog and worlds

These public routes use GET. The event stream uses server-sent events; the other routes return JSON. World lists and /avatars/all return nextOffset (null at the end). Search uses hasMore, limit and offset; increment offset by limit while hasMore is true. The personalized foryou sort requires a signed-in session. Avatar objects are identical everywhere: id, name, description, authorId, authorName, imageUrl, tags, aiTags, platforms, performance, views, likes, promoted.

• /avatars/search?q=&tag=&author=&platform=&sort=&limit=&offset=

  Searches the local index and caches additional Nexus name and creator results. up to 60 per page. sort: recent (default), popular, name, oldest, foryou (needs a signed-in session).

• /avatars/all?offset=0&limit=1000&sort=

  Every cached, listed avatar in pages of up to 1000 (sort: recent, popular, name). Follow nextOffset until it is null. 30 calls a minute.

• /avatars/events

  Server-sent events. Sends moderation frames ({type:"blocked"|"unblocked", id, at}) and exact counter frames ({type:"counts", id, views, likes, at}).

• /avatars/:id

  One avatar with the same public shape as the lists.

• /insights/overview?days=30

  Site-wide analytics for a 7 to 90 day window: totals, the window before, percent trend, a daily series and leaderboards (views, trending, click-through, likes).

• /insights/avatars?q=&sort=&platform=&days=&limit=&offset=

  Every listed avatar ranked by views, trending, impressions, outbound, ctr, likes, favorites or newest. Each row has lifetime and window totals, trend, rates and a 14 day sparkline.

• /insights/avatars/:id?days=30

  Deep dive: daily series for every counter, audience buckets (search terms, site surface, referrer, device, country, hour), rank and percentile, peak day, activity span.

• /world/list?sort=&platform=&tag=&limit=500&offset=

  Long JSON list for worlds. Same avatar objects, plus total, count, nextOffset.

• /world/all?offset=0

  The whole catalog in pages of 1000, JSON, no key.

• /world/promoted/avatars and /world/promoted/groups

  Paid placements, avatars and groups, with images and ids. Also /world/promoted for both.

• /world/avatars?ids=avtr_a,avtr_b

  Batch lookup by id. Unknown ids are echoed back in missing.

• /world/supporters

  Patreon supporter names and tiers recorded from AviSeek users signing in with VRChat Legends.

• /world/client?q=robot&offset=0

  Public batches of 120 avatars with compact thumbnails and performance ratings. No account token needed.

• /world/bundle

  Everything a lobby board needs in one call: trending, promoted, groups, supporters, stats.

• /world/endpoints

  Machine readable table of every world route with parameters and limits.

Read the API reference for request and response schemas.