Creator AI Search

Reference example

# Fixed reference example. Playground inputs do not update this sample.
curl --request POST \
  --url https://api.aisa.one/apis/v1/waveinflu/ai-search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "query": "beauty creators in the US"
}'

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

import requests

url = "https://api.aisa.one/apis/v1/waveinflu/ai-search"

payload = { "query": "beauty creators in the US" }
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({query: 'beauty creators in the US'})
};

fetch('https://api.aisa.one/apis/v1/waveinflu/ai-search', 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/ai-search",
  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([
    'query' => 'beauty creators in the US'
  ]),
  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/ai-search"

	payload := strings.NewReader("{\n  \"query\": \"beauty creators in the US\"\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/ai-search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"beauty creators in the US\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/waveinflu/ai-search")

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  \"query\": \"beauty creators in the US\"\n}"

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

{
  "billingRequestId": "3f522b56-2bb4-426c-9b76-5c04c91a9cb3",
  "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-b6l"
}

POST

https://api.aisa.one

apis

waveinflu

ai-search

Reference example

# Fixed reference example. Playground inputs do not update this sample.
curl --request POST \
  --url https://api.aisa.one/apis/v1/waveinflu/ai-search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "query": "beauty creators in the US"
}'

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

import requests

url = "https://api.aisa.one/apis/v1/waveinflu/ai-search"

payload = { "query": "beauty creators in the US" }
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({query: 'beauty creators in the US'})
};

fetch('https://api.aisa.one/apis/v1/waveinflu/ai-search', 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/ai-search",
  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([
    'query' => 'beauty creators in the US'
  ]),
  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/ai-search"

	payload := strings.NewReader("{\n  \"query\": \"beauty creators in the US\"\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/ai-search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"beauty creators in the US\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/waveinflu/ai-search")

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  \"query\": \"beauty creators in the US\"\n}"

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

{
  "billingRequestId": "3f522b56-2bb4-426c-9b76-5c04c91a9cb3",
  "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-b6l"
}

Finds creators from a natural-language brief instead of a seed account. platform and query are required; add limit (1–100, default 25) 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

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
      }'

// 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_ai_search",
      "arguments": {
        "platform": "instagram",
        "query": "beauty creators in the US",
        "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-ai-search.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/ai-search
Availability: enabled
Request URL template: https://api.aisa.one/apis/v1/waveinflu/ai-search
Runtime facts: 96bc534d9fbbbba2be7e31d47a464528a786fc23d7064691a909226aee67a0a8

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

{
  "operationId": "post_waveinflu_ai_search",
  "method": "POST",
  "path": "/apis/v1/waveinflu/ai-search",
  "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. [\"solo_creator\", \"brand_account\"].",
                  "items": {
                    "enum": [
                      "solo_creator",
                      "couple",
                      "family",
                      "group",
                      "product_only",
                      "brand_account",
                      "media_publisher",
                      "organization",
                      "content_aggregator",
                      "virtual_creator"
                    ],
                    "type": "string"
                  },
                  "type": "array"
                },
                "ethnicities": {
                  "description": "Inferred creator ethnicities, e.g. [\"asian\", \"hispanic_latino\"].",
                  "items": {
                    "enum": [
                      "white",
                      "black",
                      "asian",
                      "hispanic_latino",
                      "middle_eastern",
                      "indigenous",
                      "pacific_islander",
                      "multiracial"
                    ],
                    "type": "string"
                  },
                  "type": "array"
                },
                "faceVisibilities": {
                  "description": "Face-visibility classifications, e.g. [\"clear_face\", \"mixed\", \"no_face\"].",
                  "items": {
                    "enum": [
                      "clear_face",
                      "partial_face",
                      "no_face",
                      "mixed"
                    ],
                    "type": "string"
                  },
                  "type": "array"
                },
                "genders": {
                  "description": "Inferred creator genders, e.g. [\"female\", \"male\"].",
                  "items": {
                    "enum": [
                      "female",
                      "male"
                    ],
                    "type": "string"
                  },
                  "type": "array"
                },
                "languages": {
                  "description": "Creator languages. Chinese uses `zh-Hans` (Simplified), `zh-Hant` (Traditional) or `zh`; region-style tags such as `zh-cn` are rejected. E.g. [\"en\", \"ja\", \"zh-Hans\"].",
                  "items": {
                    "enum": [
                      "en",
                      "es",
                      "pt",
                      "fr",
                      "de",
                      "ko",
                      "ja",
                      "ar",
                      "ru",
                      "it",
                      "zh-Hant",
                      "tr",
                      "id",
                      "hi",
                      "pl",
                      "vi",
                      "th",
                      "nl",
                      "fa",
                      "zh-Hans",
                      "bn",
                      "da",
                      "uk",
                      "ro",
                      "sv",
                      "el",
                      "ms",
                      "cs",
                      "he",
                      "hu",
                      "mr",
                      "fi",
                      "sr",
                      "hr",
                      "ml",
                      "no",
                      "ta",
                      "tl",
                      "zh"
                    ],
                    "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"
            },
            "query": {
              "description": "Natural-language description of the creators you are looking for.",
              "example": "beauty creators in the US",
              "type": "string"
            }
          },
          "required": [
            "query"
          ],
          "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.15,
    "estimate_source": "profile_seed",
    "evidence_source": "response_body",
    "maximum_units": 100,
    "unit": "ai_search_creator",
    "unit_rate_usd": 0.006
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Usage-based billing; Default request estimate: $0.15 USD (not a fixed price). Declared unit rate: $0.006 USD per ai_search_creator. 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.15
Declared unit rate (USD): 0.006
Billing unit: ai_search_creator
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

query

string

required

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

Example:

"beauty creators in the US"

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

Creators returned

billingRequestId

string

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

Example:

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

data

object

Show child attributes

requestId

string

Request ID for support and monitoring.

Example:

"req-b6l"

Overview

Models

Search & Research

Finance & Crypto

Social & Media

SEO & Web Intel

Sales & Email

Travel & Other

Media Generation

Oxylabs Web API

Creator AI Search

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