Get top contents list

curl --request POST \
  --url https://api.aisa.one/apis/v1/tikhub/tiktok/ads/get_top_contents_list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "period_end_timestamp": 1785024000,
  "period_dimension": 1,
  "country_code": "US",
  "content_label_ids": "",
  "order_by_metric": 1,
  "organic_only": false,
  "page": 1,
  "limit": 20,
  "cookie": "<string>"
}
'

import requests

url = "https://api.aisa.one/apis/v1/tikhub/tiktok/ads/get_top_contents_list"

payload = {
    "period_end_timestamp": 1785024000,
    "period_dimension": 1,
    "country_code": "US",
    "content_label_ids": "",
    "order_by_metric": 1,
    "organic_only": False,
    "page": 1,
    "limit": 20,
    "cookie": "<string>"
}
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({
    period_end_timestamp: 1785024000,
    period_dimension: 1,
    country_code: 'US',
    content_label_ids: '',
    order_by_metric: 1,
    organic_only: false,
    page: 1,
    limit: 20,
    cookie: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/tikhub/tiktok/ads/get_top_contents_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/tiktok/ads/get_top_contents_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([
    'period_end_timestamp' => 1785024000,
    'period_dimension' => 1,
    'country_code' => 'US',
    'content_label_ids' => '',
    'order_by_metric' => 1,
    'organic_only' => false,
    'page' => 1,
    'limit' => 20,
    'cookie' => '<string>'
  ]),
  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/tiktok/ads/get_top_contents_list"

	payload := strings.NewReader("{\n  \"period_end_timestamp\": 1785024000,\n  \"period_dimension\": 1,\n  \"country_code\": \"US\",\n  \"content_label_ids\": \"\",\n  \"order_by_metric\": 1,\n  \"organic_only\": false,\n  \"page\": 1,\n  \"limit\": 20,\n  \"cookie\": \"<string>\"\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/tiktok/ads/get_top_contents_list")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"period_end_timestamp\": 1785024000,\n  \"period_dimension\": 1,\n  \"country_code\": \"US\",\n  \"content_label_ids\": \"\",\n  \"order_by_metric\": 1,\n  \"organic_only\": false,\n  \"page\": 1,\n  \"limit\": 20,\n  \"cookie\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/tikhub/tiktok/ads/get_top_contents_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  \"period_end_timestamp\": 1785024000,\n  \"period_dimension\": 1,\n  \"country_code\": \"US\",\n  \"content_label_ids\": \"\",\n  \"order_by_metric\": 1,\n  \"organic_only\": false,\n  \"page\": 1,\n  \"limit\": 20,\n  \"cookie\": \"<string>\"\n}"

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

POST

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

tikhub

tiktok

ads

get_top_contents_list

Get top contents list

curl --request POST \
  --url https://api.aisa.one/apis/v1/tikhub/tiktok/ads/get_top_contents_list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "period_end_timestamp": 1785024000,
  "period_dimension": 1,
  "country_code": "US",
  "content_label_ids": "",
  "order_by_metric": 1,
  "organic_only": false,
  "page": 1,
  "limit": 20,
  "cookie": "<string>"
}
'

import requests

url = "https://api.aisa.one/apis/v1/tikhub/tiktok/ads/get_top_contents_list"

payload = {
    "period_end_timestamp": 1785024000,
    "period_dimension": 1,
    "country_code": "US",
    "content_label_ids": "",
    "order_by_metric": 1,
    "organic_only": False,
    "page": 1,
    "limit": 20,
    "cookie": "<string>"
}
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({
    period_end_timestamp: 1785024000,
    period_dimension: 1,
    country_code: 'US',
    content_label_ids: '',
    order_by_metric: 1,
    organic_only: false,
    page: 1,
    limit: 20,
    cookie: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/tikhub/tiktok/ads/get_top_contents_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/tiktok/ads/get_top_contents_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([
    'period_end_timestamp' => 1785024000,
    'period_dimension' => 1,
    'country_code' => 'US',
    'content_label_ids' => '',
    'order_by_metric' => 1,
    'organic_only' => false,
    'page' => 1,
    'limit' => 20,
    'cookie' => '<string>'
  ]),
  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/tiktok/ads/get_top_contents_list"

	payload := strings.NewReader("{\n  \"period_end_timestamp\": 1785024000,\n  \"period_dimension\": 1,\n  \"country_code\": \"US\",\n  \"content_label_ids\": \"\",\n  \"order_by_metric\": 1,\n  \"organic_only\": false,\n  \"page\": 1,\n  \"limit\": 20,\n  \"cookie\": \"<string>\"\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/tiktok/ads/get_top_contents_list")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"period_end_timestamp\": 1785024000,\n  \"period_dimension\": 1,\n  \"country_code\": \"US\",\n  \"content_label_ids\": \"\",\n  \"order_by_metric\": 1,\n  \"organic_only\": false,\n  \"page\": 1,\n  \"limit\": 20,\n  \"cookie\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/tikhub/tiktok/ads/get_top_contents_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  \"period_end_timestamp\": 1785024000,\n  \"period_dimension\": 1,\n  \"country_code\": \"US\",\n  \"content_label_ids\": \"\",\n  \"order_by_metric\": 1,\n  \"organic_only\": false,\n  \"page\": 1,\n  \"limit\": 20,\n  \"cookie\": \"<string>\"\n}"

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

Get top contents list 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/tiktok/ads/get_top_contents_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

period_end_timestamp

integer

required

The caller must generate this 10-digit Unix timestamp in seconds from the target ranking date, for example 1785024000; do not pass 0 because it returns an empty result

Example:

1785024000

period_dimension

integer

default:3

Period dimension: 1/3/5

Example:

1

country_code

string

default:US

Country/region code

content_label_ids

string

default:""

Content label IDs, comma separated

order_by_metric

integer

default:1

Order by metric: 1=Views, 2=Engagement rate, 3=6-second completion rate

Example:

1

organic_only

boolean

default:false

Organic content only

page

integer

default:1

Page number

limit

integer

default:20

Items per page, max 100

Custom Cookie string (optional)

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 top contents list

Example

Authorizations

Body

Response

​Example

Authorizations

Body

Response

Example