AI Search

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

import requests

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

payload = {
    "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
    }
}
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',
    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
    }
  })
};

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([
    '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
    ]
  ]),
  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  \"platform\": \"instagram\",\n  \"query\": \"beauty creators in the US\",\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/ai-search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"platform\": \"instagram\",\n  \"query\": \"beauty creators in the US\",\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/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  \"platform\": \"instagram\",\n  \"query\": \"beauty creators in the US\",\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-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
  }
}

POST

https://api.aisa.one/apis/v1

waveinflu

ai-search

AI Search

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

import requests

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

payload = {
    "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
    }
}
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',
    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
    }
  })
};

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([
    '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
    ]
  ]),
  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  \"platform\": \"instagram\",\n  \"query\": \"beauty creators in the US\",\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/ai-search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"platform\": \"instagram\",\n  \"query\": \"beauty creators in the US\",\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/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  \"platform\": \"instagram\",\n  \"query\": \"beauty creators in the US\",\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-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

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.
{
  "operation_id": "post_waveinflu_ai_search",
  "arguments": {
    "platform": "instagram",
    "query": "beauty creators in the US",
    "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-ai-search.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"

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

Overview

Chat API

Embeddings & Rerank

Search API

Perplexity API

Financial API

Twitter API

Reddit API

Instagram API

Pinterest API

Scholar API

WaveInflu API

Prediction Market API

CoinGecko

DataForSEO

AgentMail

Apollo

Ahrefs API

Semrush API

Foreplay API

CNPJá API

Open-Meteo API

SimilarWeb API

Essentials

TikHub API

AI Search

Example

Authorizations

Body

Response

​Example

Authorizations

Body

Response

Example