AI Search

Find creators from a natural-language brief on Instagram, TikTok, or YouTube.

POST https://api.aisa.one/apis/v1/waveinflu/ai-search

AI Search

cURL

curl --request POST \
  --url https://api.aisa.one/apis/v1/waveinflu/ai-search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "platform": "instagram",
  "query": "beauty creators in the US",
  "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
  }
}
'

200

{
  "requestId": "req-b6l",
  "billingRequestId": "3f522b56-2bb4-426c-9b76-5c04c91a9cb3",
  "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 from a natural-language brief instead of a seed account. platform and query are required; add limit (1–100, default 40) and the same optional filters as Similar Creators — regions, languages, follower and play-count ranges, gender, ethnicity, creator type, face visibility, and workspace deduplication.

Describe the creators you want in plain language (for example, "beauty creators in the US") and the response returns matching creators in the same rich shape as Similar Creators: 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.

Have a specific seed account instead of a brief? Use post_waveinflu_similar_creators. Most matches already include an email; use post_waveinflu_email_lookup for the ones that come back null.

Billing is per delivered creator (data.count).

Example

REST

curl -X POST "https://api.aisa.one/apis/v1/waveinflu/ai-search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "platform": "instagram",
        "query": "beauty creators in the US",
        "limit": 10
      }'

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"

query · string · required

Natural-language description of the creators you are looking for.

Example:

"beauty creators in the US"

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

Creators returned

requestId · string

Request ID for support and monitoring.

Example:

"req-b6l"

billingRequestId · string

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

Example:

"3f522b56-2bb4-426c-9b76-5c04c91a9cb3"

data · object

Show child attributes