Skip to main content
POST
/
api
/
niconico
/
videos
/
search
/niconico/videos/search
curl --request POST \
  --url https://api.anysite.io/api/niconico/videos/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "keyword": "初音ミク",
  "tag": "VOCALOID",
  "sort_key": "hot",
  "sort_order": "desc",
  "content_type": "long",
  "genres": [],
  "min_duration_seconds": 1,
  "max_duration_seconds": 1,
  "uploaded_after": "2024-01-01",
  "uploaded_before": "2024-12-31",
  "search_by_user": false
}
'
[
  {
    "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 results

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

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
keyword
string | null

Free-text search keyword

Example:

"初音ミク"

​
tag
string | null

Exact tag to search by (tag search mode)

Example:

"VOCALOID"

​
sort_key
enum<string>
default:hot

Result ordering key

Available options:
hot,
registered_at,
view_count,
last_comment_time,
like_count,
comment_count,
mylist_count,
duration
​
sort_order
enum<string>
default:desc

Sort direction

Available options:
desc,
asc,
none
​
content_type
enum<string>
default:long

Video length category: long videos or shorts

Available options:
long,
short
​
genres
enum<string>[]

Filter by one or more genres

Available options:
entertainment,
radio,
music_sound,
dance,
animal,
nature,
cooking,
traveling_outdoor,
vehicle,
sports,
society_politics_news,
technology_craft,
commentary_lecture,
anime,
game,
other,
r18
​
min_duration_seconds
integer | null

Minimum video duration in seconds

Required range: x >= 0
​
max_duration_seconds
integer | null

Maximum video duration in seconds

Required range: x >= 0
​
uploaded_after
string | null

Only videos uploaded on or after this date (YYYY-MM-DD)

Example:

"2024-01-01"

​
uploaded_before
string | null

Only videos uploaded on or before this date (YYYY-MM-DD)

Example:

"2024-12-31"

​
search_by_user
boolean
default:false

Match the keyword against the uploader instead of the video

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