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

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

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

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

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.
{
  "calls": [
    {
      "call_id": "1",
      "tool": "post_waveinflu_similar_creators",
      "arguments": {
        "platform": "instagram",
        "target_account": "@onkimia",
        "limit": 10
      }
    }
  ]
}
// ── for the agent ─────────────────────────────────────────────────────────
// Register the AIsa MCP server, then call its `batch_quote` 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 reaches https://mcp.aisa.one/servers worth of APIs through a few meta
// tools: search, list_categories, get_details, batch_quote, batch_use.
// search, get_details and batch_quote are free; batch_use is billed per
// call. 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
// Show me the quoted cost. Once I approve, run the same calls with
// batch_use 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 a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is 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 →

Request contract

Method and path: POST /apis/v1/waveinflu/similar
Availability: enabled
Request URL template: https://api.aisa.one/apis/v1/waveinflu/similar
Runtime facts: 07c55e3b4ddc50d84ed500d7a6565527fe43b35f658661845202ff79800fe621

Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "post_waveinflu_similar_creators",
  "method": "POST",
  "path": "/apis/v1/waveinflu/similar",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "properties": {
            "filters": {
              "description": "Optional filters applied before matching. All fields are optional.",
              "properties": {
                "creatorTypes": {
                  "description": "Creator account types, e.g. [\"individual\", \"brand\"].",
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "ethnicities": {
                  "description": "Inferred creator ethnicities.",
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "faceVisibilities": {
                  "description": "Face-visibility classifications, e.g. [\"clear_face\", \"mixed\", \"no_face\"].",
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "genders": {
                  "description": "Inferred creator genders, e.g. [\"female\", \"male\"].",
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "languages": {
                  "description": "Creator languages, e.g. [\"en\", \"ja\", \"zh-cn\"].",
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "maxFollowers": {
                  "description": "Maximum follower / subscriber count.",
                  "type": "number"
                },
                "maxPlayCount": {
                  "description": "Maximum play / view count, measured by `playCountMetric`.",
                  "type": "number"
                },
                "minFollowers": {
                  "description": "Minimum follower / subscriber count.",
                  "type": "number"
                },
                "minPlayCount": {
                  "description": "Minimum play / view count, measured by `playCountMetric`.",
                  "type": "number"
                },
                "playCountMetric": {
                  "description": "Whether `minPlayCount` / `maxPlayCount` are compared against the median or the average play count.",
                  "enum": [
                    "median",
                    "average"
                  ],
                  "type": "string"
                },
                "regions": {
                  "description": "Creator regions (ISO country codes), e.g. [\"US\", \"GB\", \"JP\"].",
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "workspaceDeduplicationEnabled": {
                  "description": "When true, creators already saved in your workspace are excluded from the results.",
                  "type": "boolean"
                }
              },
              "type": "object"
            },
            "limit": {
              "default": 25,
              "description": "Maximum number of creators to return. Default 25, range 1–100. Caps the billed count.",
              "example": 10,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            },
            "platform": {
              "default": "youtube",
              "description": "Target platform.",
              "enum": [
                "instagram",
                "tiktok",
                "youtube"
              ],
              "example": "instagram",
              "type": "string"
            },
            "target_account": {
              "description": "Seed account: a creator handle (with or without @) or profile URL to find similar creators for.",
              "example": "@onkimia",
              "type": "string"
            }
          },
          "required": [
            "target_account"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "response_units",
    "customer_multiplier": 1.0,
    "customer_pricing": "provider_cost_multiplier",
    "default_request_estimate_usd": 0.124425,
    "estimate_source": "profile_seed",
    "evidence_source": "response_body",
    "maximum_units": 100,
    "unit": "similar_creator_point",
    "unit_rate_usd": 0.004977
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Usage-based billing; Default request estimate: $0.124425 USD (not a fixed price). Declared unit rate: $0.004977 USD per similar_creator_point. Account-specific pricing and final settlement may differ. 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"

filters

object

Optional filters applied before matching. All fields are optional.

Show child attributes

limit

integer

default:25

Maximum number of creators to return. Default 25, range 1–100. Caps the billed count.

Required range: 1 <= x <= 100

Example:

10

platform

enum<string>

default:youtube

Target platform.

Available options:

instagram,

tiktok,

youtube

Example:

"instagram"

Response

Similar creators returned

billingRequestId

string

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

Example:

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

data

object

Show child attributes

requestId

string

Request ID for support and monitoring.

Example:

"req-b33"

Overview

Models

Search & Research

Finance & Crypto

Social & Media

SEO & Web Intel

Sales & Email

Travel & Other

Similar Creators

Example

Request contract

Cost and request rules

Authorizations

Body

Response

​Example

​Request contract

​Cost and request rules

Authorizations

Body

Response

Example

Request contract

Cost and request rules