Similar Creators

Reference example

# Fixed reference example. Playground inputs do not update this sample.
curl --request POST \
  --url https://api.aisa.one/apis/v1/waveinflu/similar \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "target_account": "@onkimia"
}'

curl --request POST \
  --url https://api.aisa.one/apis/v1/waveinflu/similar \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "target_account": "@onkimia"
}
'

import requests

url = "https://api.aisa.one/apis/v1/waveinflu/similar"

payload = { "target_account": "@onkimia" }
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({target_account: '@onkimia'})
};

fetch('https://api.aisa.one/apis/v1/waveinflu/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/apis/v1/waveinflu/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([
    'target_account' => '@onkimia'
  ]),
  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/waveinflu/similar"

	payload := strings.NewReader("{\n  \"target_account\": \"@onkimia\"\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/waveinflu/similar")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"target_account\": \"@onkimia\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/waveinflu/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  \"target_account\": \"@onkimia\"\n}"

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

{
  "requestId": "req-b33",
  "billingRequestId": "a328145e-3cc9-45c7-89f9-a5f15b236d4f",
  "data": {
    "items": [
      {
        "id": "<string>",
        "username": "<string>",
        "fullName": "<string>",
        "biography": "<string>",
        "email": "<string>",
        "followerCount": 123,
        "region": "<string>",
        "language": "<string>",
        "averagePlayCount": 123,
        "medianPlayCount": 123,
        "averageEngagementRate": 123,
        "medianEngagementRate": 123,
        "gender": "<string>",
        "ageRange": "<string>",
        "ethnicity": "<string>",
        "faceVisibility": "<string>",
        "accountPositioning": [
          "<string>"
        ],
        "aiDescription": "<string>",
        "platform": "<string>",
        "profileUrl": "<string>",
        "score": 123
      }
    ],
    "count": 2
  }
}

POST

https://api.aisa.one

apis

waveinflu

similar

Reference example

# Fixed reference example. Playground inputs do not update this sample.
curl --request POST \
  --url https://api.aisa.one/apis/v1/waveinflu/similar \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "target_account": "@onkimia"
}'

curl --request POST \
  --url https://api.aisa.one/apis/v1/waveinflu/similar \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "target_account": "@onkimia"
}
'

import requests

url = "https://api.aisa.one/apis/v1/waveinflu/similar"

payload = { "target_account": "@onkimia" }
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({target_account: '@onkimia'})
};

fetch('https://api.aisa.one/apis/v1/waveinflu/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/apis/v1/waveinflu/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([
    'target_account' => '@onkimia'
  ]),
  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/waveinflu/similar"

	payload := strings.NewReader("{\n  \"target_account\": \"@onkimia\"\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/waveinflu/similar")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"target_account\": \"@onkimia\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/waveinflu/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  \"target_account\": \"@onkimia\"\n}"

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

{
  "requestId": "req-b33",
  "billingRequestId": "a328145e-3cc9-45c7-89f9-a5f15b236d4f",
  "data": {
    "items": [
      {
        "id": "<string>",
        "username": "<string>",
        "fullName": "<string>",
        "biography": "<string>",
        "email": "<string>",
        "followerCount": 123,
        "region": "<string>",
        "language": "<string>",
        "averagePlayCount": 123,
        "medianPlayCount": 123,
        "averageEngagementRate": 123,
        "medianEngagementRate": 123,
        "gender": "<string>",
        "ageRange": "<string>",
        "ethnicity": "<string>",
        "faceVisibility": "<string>",
        "accountPositioning": [
          "<string>"
        ],
        "aiDescription": "<string>",
        "platform": "<string>",
        "profileUrl": "<string>",
        "score": 123
      }
    ],
    "count": 2
  }
}

Finds creators similar to a seed account on Instagram, TikTok, or YouTube. platform and target_account are required; add limit (1–100, default 40) and optional filters for regions, languages, follower and play-count ranges, gender, ethnicity, creator type, face visibility, and workspace deduplication. Each match returns a rich profile: id, username, fullName, biography, email, followerCount, averagePlayCount / medianPlayCount, averageEngagementRate / medianEngagementRate, region, language, AI-inferred gender, ageRange, ethnicity, faceVisibility, accountPositioning tags, an aiDescription, profileUrl, and a relevance score. Results are sorted by score descending. Prefer a natural-language brief over a seed account? Use post_waveinflu_ai_search, which returns the same creator shape. Most matches already include an email. Use post_waveinflu_email_lookup for the ones that come back null.

Breaking change (migration to hiCreator upstream). The seed is now a single required target_account (previously seedProfileUrl / contentDirection). The response is data.items[] with data.count (previously data.data[] with total), and each match uses score (previously similarityScore). The mode, sourceUserId, and quota fields have been removed, and new profile fields (biography, gender, ageRange, ethnicity, faceVisibility, accountPositioning, aiDescription) have been added. Billing is per delivered creator (data.count).

Example

curl -X POST "https://api.aisa.one/apis/v1/waveinflu/similar" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "platform": "instagram",
        "target_account": "@onkimia",
        "limit": 10
      }'

// Copy this whole block into Claude Code, Codex, Cursor or any coding agent.
// It carries everything needed to connect, authorize and run this example —
// no key to paste, one click of Allow in the browser.
{
  "operation_id": "post_waveinflu_similar_creators",
  "arguments": {
    "platform": "instagram",
    "target_account": "@onkimia",
    "limit": 10
  },
  "max_price_usd": 0.5
}
// ── for the agent ─────────────────────────────────────────────────────────
// Register the AIsa MCP server, then call its `use` tool with the JSON above.
//   name       aisa
//   endpoint   https://mcp.aisa.one/mcp
//   transport  streamable-http
//   auth       OAuth. The server publishes RFC 9728 metadata, so open a
//              browser and the user clicks Allow once — nothing to paste.
//              If AISA_API_KEY is set, send it as a bearer header instead.
// Use your own MCP mechanism, not a hand-edited config file:
//   Codex        codex mcp add aisa --url https://mcp.aisa.one/mcp
//   Claude Code  claude mcp add --transport http -s user aisa https://mcp.aisa.one/mcp
//   Cursor / VS Code   a "url" entry for https://mcp.aisa.one/mcp in the MCP config
// The server lists five tools over https://mcp.aisa.one/servers worth of APIs:
// search, get_details, use, batch_use, list_categories. search and
// get_details are free; use is billed per call and max_price_usd refuses
// anything above the cap before spending. This operation's full contract —
// every argument, the response shape, the price and the pitfalls — is at
//   https://aisa.one/docs/api-reference/waveinflu/post_waveinflu-similar.md
// Then run the call and show me the result.

First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through five tools: search, list_categories and get_details are free, use and batch_use are billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.

Set this endpoint up in your agent →

Cost and request rules

Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Default request reference estimate (USD): 0.124425
Declared unit rate (USD): 0.004977
Billing unit: similar_creator_point
Cost contract: response_units
Published reference multiplier: 1.0
Declared maximum count/units: 100
Settlement evidence source: response_body

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

target_account

string

required

Seed account: a creator handle (with or without @) or profile URL to find similar creators for.

Example:

"@onkimia"

platform

enum<string>

default:youtube

Available options:

instagram,

tiktok,

youtube

limit

integer

default:25

Required range: 1 <= x <= 100

filters

object

Optional filters applied before matching. All fields are optional.

Show child attributes

Response

Similar creators returned

requestId

string

Request ID for support and monitoring.

Example:

"req-b33"

billingRequestId

string

Billing reference for this call, linked to your usage log.

Example:

"a328145e-3cc9-45c7-89f9-a5f15b236d4f"

data

object

Show child attributes

Overview

Models

Search & Research

Finance & Crypto

Social & Media

SEO & Web Intel

Sales & Email

Travel & Other

Similar Creators

Example

Cost and request rules

Authorizations

Body

Response

​Example

​Cost and request rules

Authorizations

Body

Response

Example

Cost and request rules