Get creator rankings
curl --request POST \
--url https://api.aisa.one/v1/tasks/creators.get_rankings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"input": {
"limit": 20,
"page": 1,
"period_value": "<string>"
}
}
'import requests
url = "https://api.aisa.one/v1/tasks/creators.get_rankings"
payload = { "input": {
"limit": 20,
"page": 1,
"period_value": "<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({input: {limit: 20, page: 1, period_value: '<string>'}})
};
fetch('https://api.aisa.one/v1/tasks/creators.get_rankings', 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/v1/tasks/creators.get_rankings",
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([
'input' => [
'limit' => 20,
'page' => 1,
'period_value' => '<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/v1/tasks/creators.get_rankings"
payload := strings.NewReader("{\n \"input\": {\n \"limit\": 20,\n \"page\": 1,\n \"period_value\": \"<string>\"\n }\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/v1/tasks/creators.get_rankings")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"input\": {\n \"limit\": 20,\n \"page\": 1,\n \"period_value\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/v1/tasks/creators.get_rankings")
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 \"input\": {\n \"limit\": 20,\n \"page\": 1,\n \"period_value\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"meta": {
"approximate_fields": [
"<string>"
],
"delivered": true,
"missing_fields": {}
},
"result": {
"has_more": true,
"items": [
{
"creator": {
"avatar_url": "<string>",
"display_name": "<string>",
"follower_count": 1,
"identity": {
"native_id": "<string>",
"handle": "<string>",
"id_namespace": "<string>",
"platform": "instagram",
"profile_url": "<string>"
}
},
"metric_value": {
"amount": null,
"unit": "count",
"value": 123,
"name": "gmv",
"scope": "creator",
"window": {
"days": 1,
"end": "<string>",
"kind": "snapshot",
"label": "<string>",
"start": "<string>",
"timezone": "<string>"
}
},
"native_rank": 2,
"position": 2
}
],
"page": 2,
"page_size": 50,
"ranking": {
"direction": "asc",
"market": "<string>",
"metric": "gmv",
"native_category": "<string>",
"ranking_key": "tiktok_shop.creator_gmv.monthly",
"window": {
"days": 1,
"end": "<string>",
"kind": "snapshot",
"label": "<string>",
"start": "<string>",
"timezone": "<string>"
}
},
"total": 1
},
"status": "found",
"task": "creators.get_rankings",
"version": 1
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"request_id": "<string>",
"retry_hint": "never",
"retryable": true,
"param": "<string>",
"problems": [
"<string>"
],
"similar_tasks": [
"<string>"
],
"task_id": "<string>"
}
}Creators
Get creator rankings
Read one reviewed ranking with explicit market and period. Bindings must agree on the ranking identity; GMV, popularity and room-specific leaderboards are not interchangeable.
POST
https://api.aisa.one
/
v1
/
tasks
/
creators.get_rankings
Get creator rankings
curl --request POST \
--url https://api.aisa.one/v1/tasks/creators.get_rankings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"input": {
"limit": 20,
"page": 1,
"period_value": "<string>"
}
}
'import requests
url = "https://api.aisa.one/v1/tasks/creators.get_rankings"
payload = { "input": {
"limit": 20,
"page": 1,
"period_value": "<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({input: {limit: 20, page: 1, period_value: '<string>'}})
};
fetch('https://api.aisa.one/v1/tasks/creators.get_rankings', 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/v1/tasks/creators.get_rankings",
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([
'input' => [
'limit' => 20,
'page' => 1,
'period_value' => '<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/v1/tasks/creators.get_rankings"
payload := strings.NewReader("{\n \"input\": {\n \"limit\": 20,\n \"page\": 1,\n \"period_value\": \"<string>\"\n }\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/v1/tasks/creators.get_rankings")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"input\": {\n \"limit\": 20,\n \"page\": 1,\n \"period_value\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/v1/tasks/creators.get_rankings")
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 \"input\": {\n \"limit\": 20,\n \"page\": 1,\n \"period_value\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"meta": {
"approximate_fields": [
"<string>"
],
"delivered": true,
"missing_fields": {}
},
"result": {
"has_more": true,
"items": [
{
"creator": {
"avatar_url": "<string>",
"display_name": "<string>",
"follower_count": 1,
"identity": {
"native_id": "<string>",
"handle": "<string>",
"id_namespace": "<string>",
"platform": "instagram",
"profile_url": "<string>"
}
},
"metric_value": {
"amount": null,
"unit": "count",
"value": 123,
"name": "gmv",
"scope": "creator",
"window": {
"days": 1,
"end": "<string>",
"kind": "snapshot",
"label": "<string>",
"start": "<string>",
"timezone": "<string>"
}
},
"native_rank": 2,
"position": 2
}
],
"page": 2,
"page_size": 50,
"ranking": {
"direction": "asc",
"market": "<string>",
"metric": "gmv",
"native_category": "<string>",
"ranking_key": "tiktok_shop.creator_gmv.monthly",
"window": {
"days": 1,
"end": "<string>",
"kind": "snapshot",
"label": "<string>",
"start": "<string>",
"timezone": "<string>"
}
},
"total": 1
},
"status": "found",
"task": "creators.get_rankings",
"version": 1
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"request_id": "<string>",
"retry_hint": "never",
"retryable": true,
"param": "<string>",
"problems": [
"<string>"
],
"similar_tasks": [
"<string>"
],
"task_id": "<string>"
}
}The request and response panels use the schemas published by this API. Conditional requirements and allowed combinations are part of the request schema. Check the complete schema before combining filters or identities.
Only the listed values are priced; other values do not fall back to the catalog base price.
For tiktok_shop.creator_gmv.monthly: request price =
Billing
| Input | Price unit | Price (USD) |
|---|---|---|
| /input/ranking_key = bilibili.follower_growth | Per successful request | 0.02 |
| /input/ranking_key = douyin.hot_accounts.24h | Per successful request | 0.0034 |
| /input/ranking_key = tiktok_shop.creator_gmv.last7days | Per successful request | 0.0734 |
| /input/ranking_key = tiktok_shop.creator_gmv.monthly | Per 10 requested units | 0.09859 |
ceil(/input/limit / 10) × selected unit price, rounded up once to a multiple of USD 0.0001; maximum requested quantity 100. A successful partial result still charges the requested size.
Successful delivery is charged; a normal empty result is not charged.
Obtain an input-specific quote by sending the same request with X-AISA-Cost-Mode: quote; quoting neither executes the Task nor reserves funds. Execution reserves the estimated request charge and settles under the rules above. Use X-AISA-Max-Price-USD to cap the price.
Use an Idempotency-Key when executing a Task. For errors, inspect error.code, error.request_id, error.retryable and error.retry_hint. A reconciliation hint requires checking the existing request before retrying; do not assume a pending settlement is a refund.Authorizations
Body
application/json