Skip to main content
POST
Reference example
Finds creators similar to a seed account on Instagram, TikTok, or YouTube. platform and target_account are required; add limit (1–100, default 25) 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.
AIsa API version upgrade (includes breaking changes). 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

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
Complete OpenAPI definition Effective request declaration (including authentication and referenced schemas):

Cost and request rules

Usage-based pricing. Default request estimate: $0.124425 USD. The final charge depends on actual usage. Your account price may differ; use a request quote where supported.

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.

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
requestId
string

Request ID for support and monitoring.

Example:

"req-b33"