Get ad percentile data

curl --request POST \
  --url https://api.aisa.one/apis/v1/tikhub/tiktok/ads/get_ad_percentile \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "material_id": "<string>",
  "metric": "ctr_percentile",
  "period_type": 180,
  "cookie": "<string>"
}
'

import requests

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

payload = {
    "material_id": "<string>",
    "metric": "ctr_percentile",
    "period_type": 180,
    "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({
    material_id: '<string>',
    metric: 'ctr_percentile',
    period_type: 180,
    cookie: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/tikhub/tiktok/ads/get_ad_percentile', 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_ad_percentile",
  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([
    'material_id' => '<string>',
    'metric' => 'ctr_percentile',
    'period_type' => 180,
    '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_ad_percentile"

	payload := strings.NewReader("{\n  \"material_id\": \"<string>\",\n  \"metric\": \"ctr_percentile\",\n  \"period_type\": 180,\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_ad_percentile")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"material_id\": \"<string>\",\n  \"metric\": \"ctr_percentile\",\n  \"period_type\": 180,\n  \"cookie\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/tikhub/tiktok/ads/get_ad_percentile")

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  \"material_id\": \"<string>\",\n  \"metric\": \"ctr_percentile\",\n  \"period_type\": 180,\n  \"cookie\": \"<string>\"\n}"

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

POST

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

tikhub

tiktok

ads

get_ad_percentile

Get ad percentile data

curl --request POST \
  --url https://api.aisa.one/apis/v1/tikhub/tiktok/ads/get_ad_percentile \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "material_id": "<string>",
  "metric": "ctr_percentile",
  "period_type": 180,
  "cookie": "<string>"
}
'

import requests

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

payload = {
    "material_id": "<string>",
    "metric": "ctr_percentile",
    "period_type": 180,
    "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({
    material_id: '<string>',
    metric: 'ctr_percentile',
    period_type: 180,
    cookie: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/tikhub/tiktok/ads/get_ad_percentile', 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_ad_percentile",
  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([
    'material_id' => '<string>',
    'metric' => 'ctr_percentile',
    'period_type' => 180,
    '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_ad_percentile"

	payload := strings.NewReader("{\n  \"material_id\": \"<string>\",\n  \"metric\": \"ctr_percentile\",\n  \"period_type\": 180,\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_ad_percentile")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"material_id\": \"<string>\",\n  \"metric\": \"ctr_percentile\",\n  \"period_type\": 180,\n  \"cookie\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/tikhub/tiktok/ads/get_ad_percentile")

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  \"material_id\": \"<string>\",\n  \"metric\": \"ctr_percentile\",\n  \"period_type\": 180,\n  \"cookie\": \"<string>\"\n}"

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

Get ad percentile data 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_ad_percentile" \
  -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

material_id

string

required

Ad material ID

metric

string

default:ctr_percentile

Analysis metric (ctr_percentile, time_attr_conversion_rate_percentile, click_cnt_percentile, time_attr_convert_cnt_percentile, show_cnt_percentile)

period_type

integer

default:180

Time period (days)

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 ad percentile data

Example

Authorizations

Body

Response

​Example

Authorizations

Body

Response

Example