Discover creators
curl --request POST \
--url https://api.aisa.one/v1/tasks/creators.search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"input": {
"query": "<string>",
"creator_countries": [],
"followers_max": 500000000000,
"followers_min": 500000000000,
"limit": 20
}
}
'import requests
url = "https://api.aisa.one/v1/tasks/creators.search"
payload = { "input": {
"query": "<string>",
"creator_countries": [],
"followers_max": 500000000000,
"followers_min": 500000000000,
"limit": 20
} }
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: {
query: '<string>',
creator_countries: [],
followers_max: 500000000000,
followers_min: 500000000000,
limit: 20
}
})
};
fetch('https://api.aisa.one/v1/tasks/creators.search', 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.search",
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' => [
'query' => '<string>',
'creator_countries' => [
],
'followers_max' => 500000000000,
'followers_min' => 500000000000,
'limit' => 20
]
]),
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.search"
payload := strings.NewReader("{\n \"input\": {\n \"query\": \"<string>\",\n \"creator_countries\": [],\n \"followers_max\": 500000000000,\n \"followers_min\": 500000000000,\n \"limit\": 20\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.search")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"input\": {\n \"query\": \"<string>\",\n \"creator_countries\": [],\n \"followers_max\": 500000000000,\n \"followers_min\": 500000000000,\n \"limit\": 20\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/v1/tasks/creators.search")
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 \"query\": \"<string>\",\n \"creator_countries\": [],\n \"followers_max\": 500000000000,\n \"followers_min\": 500000000000,\n \"limit\": 20\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": "search_match"
}
]
}
]
},
"status": "found",
"task": "creators.search",
"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
Discover creators
Discover platform creators by content intent and supported hard filters. A binding must apply every requested filter or be excluded before dispatch.
POST
https://api.aisa.one
/
v1
/
tasks
/
creators.search
Discover creators
curl --request POST \
--url https://api.aisa.one/v1/tasks/creators.search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"input": {
"query": "<string>",
"creator_countries": [],
"followers_max": 500000000000,
"followers_min": 500000000000,
"limit": 20
}
}
'import requests
url = "https://api.aisa.one/v1/tasks/creators.search"
payload = { "input": {
"query": "<string>",
"creator_countries": [],
"followers_max": 500000000000,
"followers_min": 500000000000,
"limit": 20
} }
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: {
query: '<string>',
creator_countries: [],
followers_max: 500000000000,
followers_min: 500000000000,
limit: 20
}
})
};
fetch('https://api.aisa.one/v1/tasks/creators.search', 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.search",
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' => [
'query' => '<string>',
'creator_countries' => [
],
'followers_max' => 500000000000,
'followers_min' => 500000000000,
'limit' => 20
]
]),
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.search"
payload := strings.NewReader("{\n \"input\": {\n \"query\": \"<string>\",\n \"creator_countries\": [],\n \"followers_max\": 500000000000,\n \"followers_min\": 500000000000,\n \"limit\": 20\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.search")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"input\": {\n \"query\": \"<string>\",\n \"creator_countries\": [],\n \"followers_max\": 500000000000,\n \"followers_min\": 500000000000,\n \"limit\": 20\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/v1/tasks/creators.search")
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 \"query\": \"<string>\",\n \"creator_countries\": [],\n \"followers_max\": 500000000000,\n \"followers_min\": 500000000000,\n \"limit\": 20\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": "search_match"
}
]
}
]
},
"status": "found",
"task": "creators.search",
"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.
Execution reserves for
Billing
| Input | Price unit | Price (USD) |
|---|---|---|
| All valid inputs | Per delivered item | 0.12 |
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