Get DOU+ video ranking

curl --request POST \
  --url https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_video_ranking \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "time_range": 2,
  "tag_id": 634,
  "dim_type": 5,
  "adv_id": ""
}
'

import requests

url = "https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_video_ranking"

payload = {
    "time_range": 2,
    "tag_id": 634,
    "dim_type": 5,
    "adv_id": ""
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({time_range: 2, tag_id: 634, dim_type: 5, adv_id: ''})
};

fetch('https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_video_ranking', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_video_ranking",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'time_range' => 2,
    'tag_id' => 634,
    'dim_type' => 5,
    'adv_id' => ''
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_video_ranking"

	payload := strings.NewReader("{\n  \"time_range\": 2,\n  \"tag_id\": 634,\n  \"dim_type\": 5,\n  \"adv_id\": \"\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_video_ranking")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"time_range\": 2,\n  \"tag_id\": 634,\n  \"dim_type\": 5,\n  \"adv_id\": \"\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_video_ranking")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"time_range\": 2,\n  \"tag_id\": 634,\n  \"dim_type\": 5,\n  \"adv_id\": \"\"\n}"

response = http.request(request)
puts response.read_body

POST

https://api.aisa.one/apis/v1

tikhub

douyin

douplus

fetch_video_ranking

Get DOU+ video ranking

curl --request POST \
  --url https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_video_ranking \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "time_range": 2,
  "tag_id": 634,
  "dim_type": 5,
  "adv_id": ""
}
'

import requests

url = "https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_video_ranking"

payload = {
    "time_range": 2,
    "tag_id": 634,
    "dim_type": 5,
    "adv_id": ""
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({time_range: 2, tag_id: 634, dim_type: 5, adv_id: ''})
};

fetch('https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_video_ranking', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_video_ranking",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'time_range' => 2,
    'tag_id' => 634,
    'dim_type' => 5,
    'adv_id' => ''
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_video_ranking"

	payload := strings.NewReader("{\n  \"time_range\": 2,\n  \"tag_id\": 634,\n  \"dim_type\": 5,\n  \"adv_id\": \"\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_video_ranking")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"time_range\": 2,\n  \"tag_id\": 634,\n  \"dim_type\": 5,\n  \"adv_id\": \"\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_video_ranking")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"time_range\": 2,\n  \"tag_id\": 634,\n  \"dim_type\": 5,\n  \"adv_id\": \"\"\n}"

response = http.request(request)
puts response.read_body

Get DOU+ video ranking Pricing — base $0.00145 per successful call (provider cost × 1.45; final charge scales by your plan multiplier). Charged only when the upstream response body code is 200.

Response structure is not yet fully documented — refer to the actual API response.

Example

curl -X POST "https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_video_ranking" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'  # see request schema below

Authorizations

Authorization

string

header

required

AIsa API key. Get yours at https://aisa.one

Body

application/json

DOU+ Video Ranking Request Model

time_range

integer | null

default:2

Time range: 1 / 2 / 3

Example:

2

tag_id

integer | null

default:634

Category id. 601 Drama, 602 Celebrity, 606 Music, 607 Anime, 608 Gaming, 609 Current Affairs, 612 Dance, 614 Agriculture, 615 Technology, 616 Finance, 617 Parenting, 619 Lifestyle, 621 Health, 623 Emotions, 624 Culture, 625 Workplace, 626 Education, 627 Photography, 628 Food, 629 Travel, 631 Fashion, 633 Sports, 634 Entertainment, 635 Automotive

Example:

634

dim_type

integer | null

default:5

Ranking dimension: 1=Low-follower Viral, 2=High Completion Rate, 3=High Like Rate, 4=High Follower Growth Rate, 5=Popularity Index

Example:

5

adv_id

string | null

default:""

Advertiser id (optional)

Example:

""

Response

200

Successful response. Response structure varies; refer to the actual API response.

Overview

Chat API

Embeddings & Rerank

Search API

Perplexity API

Financial API

Twitter API

Reddit API

Instagram API

Pinterest API

Scholar API

WaveInflu API

Prediction Market API

CoinGecko

DataForSEO

AgentMail

Apollo

Ahrefs API

Semrush API

Foreplay API

CNPJá API

Open-Meteo API

SimilarWeb API

Essentials

TikHub API

Get DOU+ video ranking

Example

Authorizations

Body

Response

​Example

Authorizations

Body

Response

Example