Similar Creators

curl --request POST \
  --url https://api.aisa.one/apis/v1/waveinflu/similar \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "platform": "instagram",
  "target_account": "@onkimia",
  "limit": 10,
  "filters": {
    "regions": [
      "<string>"
    ],
    "languages": [
      "<string>"
    ],
    "minFollowers": 123,
    "maxFollowers": 123,
    "minPlayCount": 123,
    "maxPlayCount": 123,
    "genders": [
      "<string>"
    ],
    "ethnicities": [
      "<string>"
    ],
    "creatorTypes": [
      "<string>"
    ],
    "faceVisibilities": [
      "<string>"
    ],
    "workspaceDeduplicationEnabled": true
  }
}
'

import requests

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

payload = {
    "platform": "instagram",
    "target_account": "@onkimia",
    "limit": 10,
    "filters": {
        "regions": ["<string>"],
        "languages": ["<string>"],
        "minFollowers": 123,
        "maxFollowers": 123,
        "minPlayCount": 123,
        "maxPlayCount": 123,
        "genders": ["<string>"],
        "ethnicities": ["<string>"],
        "creatorTypes": ["<string>"],
        "faceVisibilities": ["<string>"],
        "workspaceDeduplicationEnabled": True
    }
}
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({
    platform: 'instagram',
    target_account: '@onkimia',
    limit: 10,
    filters: {
      regions: ['<string>'],
      languages: ['<string>'],
      minFollowers: 123,
      maxFollowers: 123,
      minPlayCount: 123,
      maxPlayCount: 123,
      genders: ['<string>'],
      ethnicities: ['<string>'],
      creatorTypes: ['<string>'],
      faceVisibilities: ['<string>'],
      workspaceDeduplicationEnabled: true
    }
  })
};

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([
    'platform' => 'instagram',
    'target_account' => '@onkimia',
    'limit' => 10,
    'filters' => [
        'regions' => [
                '<string>'
        ],
        'languages' => [
                '<string>'
        ],
        'minFollowers' => 123,
        'maxFollowers' => 123,
        'minPlayCount' => 123,
        'maxPlayCount' => 123,
        'genders' => [
                '<string>'
        ],
        'ethnicities' => [
                '<string>'
        ],
        'creatorTypes' => [
                '<string>'
        ],
        'faceVisibilities' => [
                '<string>'
        ],
        'workspaceDeduplicationEnabled' => true
    ]
  ]),
  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  \"platform\": \"instagram\",\n  \"target_account\": \"@onkimia\",\n  \"limit\": 10,\n  \"filters\": {\n    \"regions\": [\n      \"<string>\"\n    ],\n    \"languages\": [\n      \"<string>\"\n    ],\n    \"minFollowers\": 123,\n    \"maxFollowers\": 123,\n    \"minPlayCount\": 123,\n    \"maxPlayCount\": 123,\n    \"genders\": [\n      \"<string>\"\n    ],\n    \"ethnicities\": [\n      \"<string>\"\n    ],\n    \"creatorTypes\": [\n      \"<string>\"\n    ],\n    \"faceVisibilities\": [\n      \"<string>\"\n    ],\n    \"workspaceDeduplicationEnabled\": true\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/apis/v1/waveinflu/similar")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"platform\": \"instagram\",\n  \"target_account\": \"@onkimia\",\n  \"limit\": 10,\n  \"filters\": {\n    \"regions\": [\n      \"<string>\"\n    ],\n    \"languages\": [\n      \"<string>\"\n    ],\n    \"minFollowers\": 123,\n    \"maxFollowers\": 123,\n    \"minPlayCount\": 123,\n    \"maxPlayCount\": 123,\n    \"genders\": [\n      \"<string>\"\n    ],\n    \"ethnicities\": [\n      \"<string>\"\n    ],\n    \"creatorTypes\": [\n      \"<string>\"\n    ],\n    \"faceVisibilities\": [\n      \"<string>\"\n    ],\n    \"workspaceDeduplicationEnabled\": true\n  }\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  \"platform\": \"instagram\",\n  \"target_account\": \"@onkimia\",\n  \"limit\": 10,\n  \"filters\": {\n    \"regions\": [\n      \"<string>\"\n    ],\n    \"languages\": [\n      \"<string>\"\n    ],\n    \"minFollowers\": 123,\n    \"maxFollowers\": 123,\n    \"minPlayCount\": 123,\n    \"maxPlayCount\": 123,\n    \"genders\": [\n      \"<string>\"\n    ],\n    \"ethnicities\": [\n      \"<string>\"\n    ],\n    \"creatorTypes\": [\n      \"<string>\"\n    ],\n    \"faceVisibilities\": [\n      \"<string>\"\n    ],\n    \"workspaceDeduplicationEnabled\": true\n  }\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/v1

waveinflu

similar

Similar Creators

curl --request POST \
  --url https://api.aisa.one/apis/v1/waveinflu/similar \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "platform": "instagram",
  "target_account": "@onkimia",
  "limit": 10,
  "filters": {
    "regions": [
      "<string>"
    ],
    "languages": [
      "<string>"
    ],
    "minFollowers": 123,
    "maxFollowers": 123,
    "minPlayCount": 123,
    "maxPlayCount": 123,
    "genders": [
      "<string>"
    ],
    "ethnicities": [
      "<string>"
    ],
    "creatorTypes": [
      "<string>"
    ],
    "faceVisibilities": [
      "<string>"
    ],
    "workspaceDeduplicationEnabled": true
  }
}
'

import requests

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

payload = {
    "platform": "instagram",
    "target_account": "@onkimia",
    "limit": 10,
    "filters": {
        "regions": ["<string>"],
        "languages": ["<string>"],
        "minFollowers": 123,
        "maxFollowers": 123,
        "minPlayCount": 123,
        "maxPlayCount": 123,
        "genders": ["<string>"],
        "ethnicities": ["<string>"],
        "creatorTypes": ["<string>"],
        "faceVisibilities": ["<string>"],
        "workspaceDeduplicationEnabled": True
    }
}
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({
    platform: 'instagram',
    target_account: '@onkimia',
    limit: 10,
    filters: {
      regions: ['<string>'],
      languages: ['<string>'],
      minFollowers: 123,
      maxFollowers: 123,
      minPlayCount: 123,
      maxPlayCount: 123,
      genders: ['<string>'],
      ethnicities: ['<string>'],
      creatorTypes: ['<string>'],
      faceVisibilities: ['<string>'],
      workspaceDeduplicationEnabled: true
    }
  })
};

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([
    'platform' => 'instagram',
    'target_account' => '@onkimia',
    'limit' => 10,
    'filters' => [
        'regions' => [
                '<string>'
        ],
        'languages' => [
                '<string>'
        ],
        'minFollowers' => 123,
        'maxFollowers' => 123,
        'minPlayCount' => 123,
        'maxPlayCount' => 123,
        'genders' => [
                '<string>'
        ],
        'ethnicities' => [
                '<string>'
        ],
        'creatorTypes' => [
                '<string>'
        ],
        'faceVisibilities' => [
                '<string>'
        ],
        'workspaceDeduplicationEnabled' => true
    ]
  ]),
  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  \"platform\": \"instagram\",\n  \"target_account\": \"@onkimia\",\n  \"limit\": 10,\n  \"filters\": {\n    \"regions\": [\n      \"<string>\"\n    ],\n    \"languages\": [\n      \"<string>\"\n    ],\n    \"minFollowers\": 123,\n    \"maxFollowers\": 123,\n    \"minPlayCount\": 123,\n    \"maxPlayCount\": 123,\n    \"genders\": [\n      \"<string>\"\n    ],\n    \"ethnicities\": [\n      \"<string>\"\n    ],\n    \"creatorTypes\": [\n      \"<string>\"\n    ],\n    \"faceVisibilities\": [\n      \"<string>\"\n    ],\n    \"workspaceDeduplicationEnabled\": true\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/apis/v1/waveinflu/similar")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"platform\": \"instagram\",\n  \"target_account\": \"@onkimia\",\n  \"limit\": 10,\n  \"filters\": {\n    \"regions\": [\n      \"<string>\"\n    ],\n    \"languages\": [\n      \"<string>\"\n    ],\n    \"minFollowers\": 123,\n    \"maxFollowers\": 123,\n    \"minPlayCount\": 123,\n    \"maxPlayCount\": 123,\n    \"genders\": [\n      \"<string>\"\n    ],\n    \"ethnicities\": [\n      \"<string>\"\n    ],\n    \"creatorTypes\": [\n      \"<string>\"\n    ],\n    \"faceVisibilities\": [\n      \"<string>\"\n    ],\n    \"workspaceDeduplicationEnabled\": true\n  }\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  \"platform\": \"instagram\",\n  \"target_account\": \"@onkimia\",\n  \"limit\": 10,\n  \"filters\": {\n    \"regions\": [\n      \"<string>\"\n    ],\n    \"languages\": [\n      \"<string>\"\n    ],\n    \"minFollowers\": 123,\n    \"maxFollowers\": 123,\n    \"minPlayCount\": 123,\n    \"maxPlayCount\": 123,\n    \"genders\": [\n      \"<string>\"\n    ],\n    \"ethnicities\": [\n      \"<string>\"\n    ],\n    \"creatorTypes\": [\n      \"<string>\"\n    ],\n    \"faceVisibilities\": [\n      \"<string>\"\n    ],\n    \"workspaceDeduplicationEnabled\": true\n  }\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. The commands per client, and what each call costs, are on aisa.one/mcp.

Set this endpoint up in your agent →

Authorizations

Authorization

string

header

required

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

Body

application/json

platform

enum<string>

required

Target platform.

Available options:

instagram,

tiktok,

youtube

Example:

"instagram"

target_account

string

required

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

Example:

"@onkimia"

limit

number

default:40

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

Required range: 1 <= x <= 100

Example:

10

filters

object

Optional filters applied before matching. All fields are optional.

Show child attributes

Response

200 - application/json

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

Chat API

Embeddings & Rerank

Search API

Exa API

Perplexity API

Financial API

Twitter API

Reddit API

Instagram API

Pinterest API

Scholar API

WaveInflu API

Prediction Market API

CoinGecko

Duffel Flights

DataForSEO

AgentMail

Apollo

Ahrefs API

Semrush API

Foreplay API

CNPJá API

Open-Meteo API

SimilarWeb API

Essentials

TikHub API

Similar Creators

Example

Authorizations

Body

Response

​Example

Authorizations

Body

Response

Example