Fetch activity calendar

curl --request POST \
  --url https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_calendar_list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "city_code": "",
  "category_code": "",
  "end_date": 1735488000,
  "start_date": 1734902400
}
'

import requests

url = "https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_calendar_list"

payload = {
    "city_code": "",
    "category_code": "",
    "end_date": 1735488000,
    "start_date": 1734902400
}
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({city_code: '', category_code: '', end_date: 1735488000, start_date: 1734902400})
};

fetch('https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_calendar_list', 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/billboard/fetch_hot_calendar_list",
  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([
    'city_code' => '',
    'category_code' => '',
    'end_date' => 1735488000,
    'start_date' => 1734902400
  ]),
  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/billboard/fetch_hot_calendar_list"

	payload := strings.NewReader("{\n  \"city_code\": \"\",\n  \"category_code\": \"\",\n  \"end_date\": 1735488000,\n  \"start_date\": 1734902400\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/billboard/fetch_hot_calendar_list")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"city_code\": \"\",\n  \"category_code\": \"\",\n  \"end_date\": 1735488000,\n  \"start_date\": 1734902400\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"city_code\": \"\",\n  \"category_code\": \"\",\n  \"end_date\": 1735488000,\n  \"start_date\": 1734902400\n}"

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

{
  "code": 200,
  "request_id": "<string>",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "Request successful; this request will be billed.",
  "support": "Discord: https://discord.gg/aMEAS8Xsvz",
  "time": "<string>",
  "time_stamp": 123,
  "time_zone": "America/Los_Angeles",
  "docs": "<string>",
  "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": "This response has been cached and can be viewed directly via the URL below; it is valid for 24 hours and accessing the cached link incurs no additional charge. The cache is for request tracing only and does not affect the freshness of the API data, nor will it be returned again through the API.",
  "cache_url": "<string>",
  "router": "",
  "params": {},
  "data": "<unknown>"
}

POST

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

tikhub

douyin

billboard

fetch_hot_calendar_list

Fetch activity calendar

curl --request POST \
  --url https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_calendar_list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "city_code": "",
  "category_code": "",
  "end_date": 1735488000,
  "start_date": 1734902400
}
'

import requests

url = "https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_calendar_list"

payload = {
    "city_code": "",
    "category_code": "",
    "end_date": 1735488000,
    "start_date": 1734902400
}
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({city_code: '', category_code: '', end_date: 1735488000, start_date: 1734902400})
};

fetch('https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_calendar_list', 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/billboard/fetch_hot_calendar_list",
  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([
    'city_code' => '',
    'category_code' => '',
    'end_date' => 1735488000,
    'start_date' => 1734902400
  ]),
  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/billboard/fetch_hot_calendar_list"

	payload := strings.NewReader("{\n  \"city_code\": \"\",\n  \"category_code\": \"\",\n  \"end_date\": 1735488000,\n  \"start_date\": 1734902400\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/billboard/fetch_hot_calendar_list")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"city_code\": \"\",\n  \"category_code\": \"\",\n  \"end_date\": 1735488000,\n  \"start_date\": 1734902400\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"city_code\": \"\",\n  \"category_code\": \"\",\n  \"end_date\": 1735488000,\n  \"start_date\": 1734902400\n}"

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

{
  "code": 200,
  "request_id": "<string>",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "Request successful; this request will be billed.",
  "support": "Discord: https://discord.gg/aMEAS8Xsvz",
  "time": "<string>",
  "time_stamp": 123,
  "time_zone": "America/Los_Angeles",
  "docs": "<string>",
  "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": "This response has been cached and can be viewed directly via the URL below; it is valid for 24 hours and accessing the cached link incurs no additional charge. The cache is for request tracing only and does not affect the freshness of the API data, nor will it be returned again through the API.",
  "cache_url": "<string>",
  "router": "",
  "params": {},
  "data": "<unknown>"
}

Fetch activity calendar 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.

Example

curl -X POST "https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_calendar_list" \
  -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

city_code

string

default:""

City code from city list; leave empty for all

category_code

string

default:""

Hot-spot ranking category code; obtained from the hot-spot ranking categories; leave empty for all

end_date

integer

default:1735488000

Snapshot end time, 10-digit Unix timestamp format

start_date

integer

default:1734902400

Snapshot start time, 10-digit timestamp format

Response

200 - application/json

Successful Response

code

integer

default:200

HTTP status code

request_id

string | null

Unique request identifier

message

string

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

Response message (EN-US)

message_zh

string

default:Request successful; this request will be billed.

Response message (ZH-CN)

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

docs

string | null

Link to the API Swagger documentation for this endpoint

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:This response has been cached and can be viewed directly via the URL below; it is valid for 24 hours and accessing the cached link incurs no additional charge. The cache is for request tracing only and does not affect the freshness of the API data, nor will it be returned again through the API.

Cache message (ZH-CN)

cache_url

string | null

The URL to access the cached result

router

string

default:""

The endpoint that generated this response

params

any

default:{}

The parameters used in the request

data

any | null

The response data

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

Fetch activity calendar

Example

Authorizations

Body

Response

​Example

Authorizations

Body

Response

Example