tiktok fetch_live_daily_rank

curl --request GET \
  --url https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_live_daily_rank \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_live_daily_rank"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_live_daily_rank', 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/tiktok/app/v3/fetch_live_daily_rank",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_live_daily_rank"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_live_daily_rank")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "cache_message": "This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.",
  "cache_message_zh": "本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。",
  "cache_url": "<string>",
  "code": 200,
  "data": "<unknown>",
  "docs": "<string>",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功，本次请求将被计费。",
  "params": {},
  "request_id": "<string>",
  "router": "",
  "support": "Discord: https://discord.gg/aMEAS8Xsvz",
  "time": "<string>",
  "time_stamp": 123,
  "time_zone": "America/Los_Angeles"
}

GET

https://api.aisa.one

apis

tikhub

tiktok

app

fetch_live_daily_rank

tiktok fetch_live_daily_rank

curl --request GET \
  --url https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_live_daily_rank \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_live_daily_rank"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_live_daily_rank', 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/tiktok/app/v3/fetch_live_daily_rank",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_live_daily_rank"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_live_daily_rank")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "cache_message": "This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.",
  "cache_message_zh": "本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。",
  "cache_url": "<string>",
  "code": 200,
  "data": "<unknown>",
  "docs": "<string>",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功，本次请求将被计费。",
  "params": {},
  "request_id": "<string>",
  "router": "",
  "support": "Discord: https://discord.gg/aMEAS8Xsvz",
  "time": "<string>",
  "time_stamp": 123,
  "time_zone": "America/Los_Angeles"
}

Get live daily rank data Pricing — billed per successful call; the final charge scales by your plan multiplier. Charged only when the upstream response body code is 200.

Example

curl "https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_live_daily_rank" \
  -H "Authorization: Bearer YOUR_API_KEY"

Request contract

Method and path: GET /apis/v1/tikhub/tiktok/app/v3/fetch_live_daily_rank
Availability: enabled
Request URL template: https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_live_daily_rank
anchor_id: query; optional
cookie: query; optional
gap_interval: query; optional
rank_type: query; optional
region_type: query; optional
room_id: query; optional
Runtime facts: 85ae03121f63417c9ff9d57a0fd59fdc6386fd71e2dc732a002843e6d8979d87

Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "get_tikhub_tiktok_app_v3_fetch_live_daily_rank",
  "method": "GET",
  "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_live_daily_rank",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [
    {
      "description": "Anchor id, which can be obtained from the live room information interface, use the default value, this parameter will affect the returned data, you can try different anchor ids of different live rooms.",
      "in": "query",
      "name": "anchor_id",
      "required": false,
      "schema": {
        "default": "6952422426752205830",
        "description": "Anchor id, which can be obtained from the live room information interface, use the default value, this parameter will affect the returned data, you can try different anchor ids of different live rooms.",
        "title": "Anchor Id",
        "type": "string"
      }
    },
    {
      "description": "User's own cookie, optional parameter, used when the interface is not available.",
      "in": "query",
      "name": "cookie",
      "required": false,
      "schema": {
        "default": "",
        "description": "User's own cookie, optional parameter, used when the interface is not available.",
        "title": "Cookie",
        "type": "string"
      }
    },
    {
      "description": "Time interval, use the default value to represent the current day, use -1 to represent the ranking record.",
      "in": "query",
      "name": "gap_interval",
      "required": false,
      "schema": {
        "default": 0,
        "description": "Time interval, use the default value to represent the current day, use -1 to represent the ranking record.",
        "title": "Gap Interval",
        "type": "integer"
      }
    },
    {
      "description": "Rank type, parameter values are as follows:",
      "in": "query",
      "name": "rank_type",
      "required": false,
      "schema": {
        "default": 8,
        "description": "Rank type, parameter values are as follows:",
        "title": "Rank Type",
        "type": "integer"
      }
    },
    {
      "description": "Region type, use the default value, the specific meaning is unknown.",
      "in": "query",
      "name": "region_type",
      "required": false,
      "schema": {
        "default": 1,
        "description": "Region type, use the default value, the specific meaning is unknown.",
        "title": "Region Type",
        "type": "integer"
      }
    },
    {
      "description": "Live room id, which can be obtained from the live room information interface, use the default value, this parameter will affect the returned data, you can try different room ids of different live rooms.",
      "in": "query",
      "name": "room_id",
      "required": false,
      "schema": {
        "default": "7380221319910312750",
        "description": "Live room id, which can be obtained from the live room information interface, use the default value, this parameter will affect the returned data, you can try different room ids of different live rooms.",
        "title": "Room Id",
        "type": "string"
      }
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "fixed_success",
    "customer_multiplier": 1.0,
    "customer_pricing": "provider_cost_multiplier",
    "default_request_estimate_usd": 0.001,
    "estimate_source": "profile_seed",
    "evidence_source": "request_snapshot"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Published reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Default request reference estimate (USD): 0.001
Cost contract: fixed_success
Published reference multiplier: 1.0
Settlement evidence source: request_snapshot

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

anchor_id

string

default:6952422426752205830

Anchor id, which can be obtained from the live room information interface, use the default value, this parameter will affect the returned data, you can try different anchor ids of different live rooms.

User's own cookie, optional parameter, used when the interface is not available.

gap_interval

integer

default:0

Time interval, use the default value to represent the current day, use -1 to represent the ranking record.

rank_type

integer

default:8

Rank type, parameter values are as follows:

region_type

integer

default:1

Region type, use the default value, the specific meaning is unknown.

room_id

string

default:7380221319910312750

Live room id, which can be obtained from the live room information interface, use the default value, this parameter will affect the returned data, you can try different room ids of different live rooms.

Response

Successful Response

Return

Live daily rank data

cache_message

string | null

default:This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.

Cache message (EN-US)

cache_message_zh

string | null

default:本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。

Cache message (ZH-CN)

cache_url

string | null

The URL to access the cached result

code

integer

default:200

HTTP status code

data

any

Endpoint-specific response payload. The official shared model does not declare a fixed type or field set. Use the operation's documented return fields or response example; an operation-specific schema, when present, describes the documented fields. Undocumented fields must be read from the actual response rather than assumed.

docs

string | null

Link to the API Swagger documentation for this endpoint

message

string

default:Request successful. This request will incur a charge.

Response message (EN-US)

message_zh

string

default:请求成功，本次请求将被计费。

Response message (ZH-CN)

params

any

default:{}

The parameters used in the request

request_id

string | null

Unique request identifier

router

string

default:""

The endpoint that generated this response

support

string

default:Discord: https://discord.gg/aMEAS8Xsvz

Support message

time

string

The time the response was generated

time_stamp

integer

The timestamp the response was generated

time_zone

string

default:America/Los_Angeles

The timezone of the response time

Overview

Models

Search & Research

Finance & Crypto

Social & Media

SEO & Web Intel

Sales & Email

Travel & Other

Media Generation

tiktok fetch_live_daily_rank

Example

Request contract

Cost and request rules

Authorizations

Query Parameters

Response

Return

​Example

​Request contract

​Cost and request rules

Authorizations

Query Parameters

Response

Return

Example

Request contract

Cost and request rules