Get creator audience and performance
curl --request POST \
--url https://api.aisa.one/v1/tasks/creators.get_audience \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"input": {
"profile_url": "<string>",
"handle": "<string>",
"native_id": "<string>"
}
}
'import requests
url = "https://api.aisa.one/v1/tasks/creators.get_audience"
payload = { "input": {
"profile_url": "<string>",
"handle": "<string>",
"native_id": "<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: {profile_url: '<string>', handle: '<string>', native_id: '<string>'}})
};
fetch('https://api.aisa.one/v1/tasks/creators.get_audience', 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_audience",
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' => [
'profile_url' => '<string>',
'handle' => '<string>',
'native_id' => '<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_audience"
payload := strings.NewReader("{\n \"input\": {\n \"profile_url\": \"<string>\",\n \"handle\": \"<string>\",\n \"native_id\": \"<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_audience")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"input\": {\n \"profile_url\": \"<string>\",\n \"handle\": \"<string>\",\n \"native_id\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/v1/tasks/creators.get_audience")
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 \"profile_url\": \"<string>\",\n \"handle\": \"<string>\",\n \"native_id\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"meta": {
"approximate_fields": [
"<string>"
],
"delivered": true,
"missing_fields": {}
},
"result": {
"by_source": [
{
"result": {
"coverage": {
"demographics": "complete",
"engagement": "complete"
},
"creator": {
"avatar_url": "<string>",
"display_name": "<string>",
"follower_count": 1,
"identity": {
"native_id": "<string>",
"handle": "<string>",
"id_namespace": "<string>",
"platform": "instagram",
"profile_url": "<string>"
}
},
"demographics": {
"distributions": [
{
"buckets": [
{
"ratio": 0.5,
"count": 1,
"key": "<string>",
"label": "<string>"
}
],
"dimension": "age"
}
],
"population": "followers",
"window": {
"days": 1,
"end": "<string>",
"kind": "snapshot",
"label": "<string>",
"start": "<string>",
"timezone": "<string>"
}
},
"engagement": {
"formula": "<string>",
"metrics": [
{
"aggregation": "mean",
"denominator": "<string>",
"name": "engagement_rate",
"unit": "count",
"value": 123
}
],
"sample_count": 1,
"usable_sample_count": 1,
"window": {
"days": 1,
"end": "<string>",
"kind": "snapshot",
"label": "<string>",
"start": "<string>",
"timezone": "<string>"
}
},
"lookup_status": "found"
},
"status": "found"
}
]
},
"status": "found",
"task": "creators.get_audience",
"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 audience and performance
Compare source-specific audience and performance reports, preserving population, denominator and actual observation window. Missing required parts are partial delivery.
POST
https://api.aisa.one
/
v1
/
tasks
/
creators.get_audience
Get creator audience and performance
curl --request POST \
--url https://api.aisa.one/v1/tasks/creators.get_audience \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"input": {
"profile_url": "<string>",
"handle": "<string>",
"native_id": "<string>"
}
}
'import requests
url = "https://api.aisa.one/v1/tasks/creators.get_audience"
payload = { "input": {
"profile_url": "<string>",
"handle": "<string>",
"native_id": "<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: {profile_url: '<string>', handle: '<string>', native_id: '<string>'}})
};
fetch('https://api.aisa.one/v1/tasks/creators.get_audience', 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_audience",
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' => [
'profile_url' => '<string>',
'handle' => '<string>',
'native_id' => '<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_audience"
payload := strings.NewReader("{\n \"input\": {\n \"profile_url\": \"<string>\",\n \"handle\": \"<string>\",\n \"native_id\": \"<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_audience")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"input\": {\n \"profile_url\": \"<string>\",\n \"handle\": \"<string>\",\n \"native_id\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/v1/tasks/creators.get_audience")
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 \"profile_url\": \"<string>\",\n \"handle\": \"<string>\",\n \"native_id\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"meta": {
"approximate_fields": [
"<string>"
],
"delivered": true,
"missing_fields": {}
},
"result": {
"by_source": [
{
"result": {
"coverage": {
"demographics": "complete",
"engagement": "complete"
},
"creator": {
"avatar_url": "<string>",
"display_name": "<string>",
"follower_count": 1,
"identity": {
"native_id": "<string>",
"handle": "<string>",
"id_namespace": "<string>",
"platform": "instagram",
"profile_url": "<string>"
}
},
"demographics": {
"distributions": [
{
"buckets": [
{
"ratio": 0.5,
"count": 1,
"key": "<string>",
"label": "<string>"
}
],
"dimension": "age"
}
],
"population": "followers",
"window": {
"days": 1,
"end": "<string>",
"kind": "snapshot",
"label": "<string>",
"start": "<string>",
"timezone": "<string>"
}
},
"engagement": {
"formula": "<string>",
"metrics": [
{
"aggregation": "mean",
"denominator": "<string>",
"name": "engagement_rate",
"unit": "count",
"value": 123
}
],
"sample_count": 1,
"usable_sample_count": 1,
"window": {
"days": 1,
"end": "<string>",
"kind": "snapshot",
"label": "<string>",
"start": "<string>",
"timezone": "<string>"
}
},
"lookup_status": "found"
},
"status": "found"
}
]
},
"status": "found",
"task": "creators.get_audience",
"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.
Successful delivery is charged; a normal empty result is not charged.
Obtain an input-specific quote by sending the same request with
Billing
| Input | Price unit | Price (USD) |
|---|---|---|
| /input/platform = bilibili | Per successful request | 0.02 |
| /input/platform = douyin | Per successful request | 0.0134 |
| /input/platform = instagram | Per successful request | 1.828 |
| /input/platform = onlyfans | Per successful request | 1.5947 |
| /input/platform = tiktok | Per successful request | 2.9947 |
| /input/platform = twitch | Per successful request | 1.5947 |
| /input/platform = twitter | Per successful request | 1.5947 |
| /input/platform = xiaohongshu | Per successful request | 0.1334 |
| /input/platform = youtube | Per successful request | 1.5947 |
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