# AcFun Rankings & Video API > Live rankings and video engagement from AcFun (acfun.cn, "A站"), the pioneering Chinese ACG (anime-comic-game) video community, read keyless from AcFun's public ranking endpoint and video pages. Founded in 2007, AcFun is the platform that brought danmaku (bullet comments scrolling across the video) to China and is the cultural older sibling of Bilibili, with its own famously devoted fandom and its signature "banana" votes — the currency fans throw at videos they love. The ranking endpoint returns AcFun's video ranking over a period (day, three days or week), optionally for one channel, each video with its views, danmaku, likes, banana votes, favourites, shares and comments, its uploader and their follower count, duration and tags. The video endpoint returns one video in full by its AcFun id (the "ac" number) — the same engagement figures plus the description, read from the video page's embedded data. This is the AcFun platform cut — a distinct social and video platform, separate from Bilibili and the other video and social feeds in the catalogue, with its own banana-vote culture. Banana votes are AcFun-specific (a fan vote, not views or likes); danmaku are the scrolling comments. Counts are the real, live numbers AcFun shows; a short cache fronts the upstream. Keyless. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/acfun-api/..." ``` ## Pricing - **Free** (Free) — 850 calls/Mo, 2 req/s - **Starter** ($32/Mo) — 78,000 calls/Mo, 6 req/s - **Pro** ($84/Mo) — 520,000 calls/Mo, 16 req/s - **Scale** ($226/Mo) — 3,200,000 calls/Mo, 40 req/s ## Endpoints ### Ranking #### `GET /v1/ranking` — AcFun video ranking by period **Parameters:** - `period` (query, optional, string) — DAY, THREE_DAYS or WEEK Example: `DAY` - `limit` (query, optional, string) — Max videos (1-50) Example: `30` - `channel_id` (query, optional, string) — Optional channel id to narrow to one category **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/acfun-api/v1/ranking?period=DAY&limit=30" ``` **Response:** ```json { "data": { "note": "AcFun's video ranking over the chosen period — each video with its views, danmaku (scrolling comments), likes, banana votes (AcFun's signature fan vote, distinct from likes), favourites, shares and comments, plus its uploader, their follower count, duration and tags. period: DAY, THREE_DAYS or WEEK; optional channel_id narrows to one category; limit 1-50. Live, cached ~5m.", "count": 30, "period": "DAY", "source": "AcFun public ranking endpoint (acfun.cn/rest/pc-direct/rank/channel), keyless", "videos": [ { "url": "https://www.acfun.cn/v/ac48606016", "rank": 1, "tags": [ "steam游戏", "steam", "金亨泰", "剑星血雨", "剑星" ], "likes": 495, "title": "剑星新作人设翻车？玩家争论不休，金亨泰访谈回应【绅批】", "views": 3191, "shares": 36, "bananas": 2368, "channel": "主机单机", "danmaku": 521, "comments": 81, "uploaded": null, "uploader": "老绅", "favorites": 61, "channel_id": 84, "content_id": "48606016", "uploader_id": "526850", "uploader_fans": 1107697, …(truncated, see openapi.json for full schema) ``` ### Video #### `GET /v1/video` — One video in full by id **Parameters:** - `id` (query, required, string) — AcFun video id (the "ac" number) Example: `48606016` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/acfun-api/v1/video?id=48606016" ``` **Response:** ```json { "data": { "url": "https://www.acfun.cn/v/ac48606016", "note": "One AcFun video in full: its views, danmaku (scrolling comments), likes, banana votes, favourites, shares and comments, its uploader and their follower count, channel, duration, tags and description. Banana votes are AcFun-specific (not views or likes). Live, cached ~5m.", "tags": [ "steam游戏", "steam", "金亨泰", "剑星血雨", "剑星" ], "likes": 495, "title": "剑星新作人设翻车？玩家争论不休，金亨泰访谈回应【绅批】", "views": 3191, "shares": 36, "source": "AcFun video page embedded data (acfun.cn/v/ac{id}), keyless", "bananas": 2368, "channel": "主机单机", "danmaku": 521, "comments": 81, "uploader": "老绅", "favorites": 61, "channel_id": 84, "content_id": "48606016", "description": "别打了，打个大西瓜", "uploader_id": "526850", "uploader_fans": 1107697, "duration_seconds": 499 }, "meta": { "timestamp": "2026-06-13T04:42:36.844Z", "request_id": "02e2ca16-ec13-4fef-88ec-08c1ab5e4f52" }, "status": "ok", "message": "Video retrieved successfully", "success": true } ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/acfun-api/v1/meta" ``` **Response:** ```json { "data": { "note": "ranking takes period (DAY/THREE_DAYS/WEEK), optional channel_id and limit (1-50). video takes id (a numeric AcFun video id, the 'ac' number). meta takes no parameters. Banana votes are AcFun-specific (a fan vote, not views or likes); danmaku are the scrolling comments. Counts are live integers; a short ~5-minute cache fronts AcFun.", "sample": { "views": 3191, "bananas": 2368, "top_title": "剑星新作人设翻车？玩家争论不休，金亨泰访谈回应【绅批】" }, "source": "AcFun public ranking endpoint + video pages (acfun.cn), keyless, live", "service": "acfun-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/video": "One video in full by id (id=48606016).", "GET /v1/ranking": "AcFun video ranking by period (period=DAY, limit=30, optional channel_id)." }, "description": "Live rankings and video engagement from AcFun (acfun.cn, 'A站'), the pioneering Chinese ACG video community that brought danmaku to China — the cultural older sibling of Bilibili, with its signature 'banana' votes. The ranking endpoint returns AcFun's video ranking over a period (day/three-days/week), optionally per channel, each video with views, danmaku, likes, banana votes, favourites, shares, comments, uploader and follower count, duration and tags; the video endpoint returns one video in full by its AcFun id. The Ac …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/acfun-api OpenAPI spec: https://www.oanor.com/api/acfun-api/openapi.json