Find similar creators
curl --request POST \
--url https://api.aisa.one/v1/tasks/creators.find_similar \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"input": {
"profile_url": "<string>",
"handle": "<string>",
"limit": 20,
"native_id": "<string>"
}
}
'import requests
url = "https://api.aisa.one/v1/tasks/creators.find_similar"
payload = { "input": {
"profile_url": "<string>",
"handle": "<string>",
"limit": 20,
"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>', limit: 20, native_id: '<string>'}
})
};
fetch('https://api.aisa.one/v1/tasks/creators.find_similar', 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.find_similar",
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>',
'limit' => 20,
'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.find_similar"
payload := strings.NewReader("{\n \"input\": {\n \"profile_url\": \"<string>\",\n \"handle\": \"<string>\",\n \"limit\": 20,\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.find_similar")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"input\": {\n \"profile_url\": \"<string>\",\n \"handle\": \"<string>\",\n \"limit\": 20,\n \"native_id\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/v1/tasks/creators.find_similar")
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 \"limit\": 20,\n \"native_id\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"meta": {
"approximate_fields": [
"<string>"
],
"delivered": true,
"missing_fields": {}
},
"result": {
"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>"
}
},
"matches": [
{
"provider_rank": 2,
"provider_score": 123,
"score_scale": "<string>",
"type": "provider_recommendation"
}
]
}
]
},
"status": "found",
"task": "creators.find_similar",
"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
Find similar creators
Find source-recommended accounts similar to one reference account, excluding the seed. Scores retain their source meaning.
POST
https://api.aisa.one
/
v1
/
tasks
/
creators.find_similar
Find similar creators
curl --request POST \
--url https://api.aisa.one/v1/tasks/creators.find_similar \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"input": {
"profile_url": "<string>",
"handle": "<string>",
"limit": 20,
"native_id": "<string>"
}
}
'import requests
url = "https://api.aisa.one/v1/tasks/creators.find_similar"
payload = { "input": {
"profile_url": "<string>",
"handle": "<string>",
"limit": 20,
"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>', limit: 20, native_id: '<string>'}
})
};
fetch('https://api.aisa.one/v1/tasks/creators.find_similar', 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.find_similar",
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>',
'limit' => 20,
'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.find_similar"
payload := strings.NewReader("{\n \"input\": {\n \"profile_url\": \"<string>\",\n \"handle\": \"<string>\",\n \"limit\": 20,\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.find_similar")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"input\": {\n \"profile_url\": \"<string>\",\n \"handle\": \"<string>\",\n \"limit\": 20,\n \"native_id\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/v1/tasks/creators.find_similar")
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 \"limit\": 20,\n \"native_id\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"meta": {
"approximate_fields": [
"<string>"
],
"delivered": true,
"missing_fields": {}
},
"result": {
"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>"
}
},
"matches": [
{
"provider_rank": 2,
"provider_score": 123,
"score_scale": "<string>",
"type": "provider_recommendation"
}
]
}
]
},
"status": "found",
"task": "creators.find_similar",
"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.
Execution reserves for
Billing
| Input | Price unit | Price (USD) |
|---|---|---|
| /input/platform = bilibili | Per delivered item | 0.001 |
| /input/platform = douyin | Per delivered item | 0.001 |
| /input/platform = instagram | Per delivered item | 0.12 |
| /input/platform = tiktok | Per delivered item | 0.0166 |
| /input/platform = xiaohongshu | Per delivered item | 0.0167 |
| /input/platform = youtube | Per delivered item | 0.0166 |
ceil(/input/limit / 1) units, up to 100 units.
Settlement uses delivered units, capped at reserved units; unused reservation is released.
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