Skip to main content
POST
/
api
/
niconico
/
videos
/
ranking
/niconico/videos/ranking
curl --request POST \
  --url https://api.anysite.io/api/niconico/videos/ranking \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "genre": "all",
  "term": "24h"
}
'
[
  {
    "id": "<string>",
    "url": "<string>",
    "@type": "NiconicoVideoCard",
    "video_title": "<string>",
    "content_type": "<string>",
    "description": "<string>",
    "duration_seconds": 123,
    "view_count": 123,
    "comment_count": 123,
    "mylist_count": 123,
    "like_count": 123,
    "registered_at": 123,
    "image": "<string>",
    "latest_comment": "<string>",
    "is_channel_video": false,
    "is_payment_required": false,
    "owner": {
      "id": "<string>",
      "@type": "NiconicoOwner",
      "name": "<string>",
      "owner_type": "<string>",
      "image": "<string>",
      "url": "<string>"
    }
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
count
integer
required

Max number of ranked videos

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
genre
enum<string>
default:all

Ranking genre ('all' for overall)

Available options:
all,
entertainment,
radio,
music_sound,
dance,
animal,
nature,
cooking,
traveling_outdoor,
vehicle,
sports,
society_politics_news,
technology_craft,
commentary_lecture,
anime,
game,
other,
r18
term
enum<string>
default:24h

Ranking time window

Available options:
hour,
24h,
week,
month,
total

Response

Successful Response

id
string
required
url
string
required
@type
string
default:NiconicoVideoCard
video_title
string | null
content_type
string | null
description
string | null
duration_seconds
integer | null
view_count
integer | null
comment_count
integer | null
mylist_count
integer | null
like_count
integer | null
registered_at
integer | null
image
string | null
latest_comment
string | null
is_channel_video
boolean
default:false
is_payment_required
boolean
default:false
owner
object | null