Skip to main content
POST
/
v1
/
search
import InflushipAPI from 'influship';

const client = new InflushipAPI({
  apiKey: 'My API Key',
});

const response = await client.search.findCreators({
  query: 'fitness influencers with 100k+ followers who post workout content',
});

console.log(response.filtered_total);
{
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Sarah Fitness",
      "avatar_url": "https://example.com/avatars/sarah.jpg",
      "bio": "Certified personal trainer and wellness coach",
      "profiles": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "creator_profile_id": "123e4567-e89b-12d3-a456-426614174000",
          "platform": "instagram",
          "username": "sarah_fitness",
          "display_name": "Sarah | Fitness Coach",
          "bio": "Transform your body in 12 weeks 💪",
          "follower_count": 125000,
          "engagement_rate": 4.2,
          "verified": true,
          "avatar_url": "https://example.com/avatars/sarah.jpg",
          "external_url": "https://sarahfitness.com"
        }
      ],
      "ai_recommendation": {
        "score": 0.92,
        "explanation": "Strong match for fitness content with high engagement and authentic wellness focus"
      }
    }
  ],
  "filtered_total": 247,
  "has_more": true,
  "next_cursor": "eyJpZCI6MjUsInNjb3JlIjowLjg4fQ=="
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication

Query Parameters

​
limit
integer
default:25

Maximum number of results to return

Required range: 1 <= x <= 100
​
cursor
string

Opaque pagination cursor from previous response's next_cursor. Do not construct manually.

Example:

"eyJpZCI6MjUsInNjb3JlIjowLjg1fQ=="

Body

application/json
​
query
string
required

Natural language search query

Required string length: 1 - 500
Example:

"fitness influencers with 100k+ followers who post workout content"

​
mode
enum<string>
default:lite

Response detail level. lite returns basic fields (username, follower_count, engagement_rate). detailed adds avg_comments_recent, avg_video_views_recent, follower_change_rate, etc. Detailed mode costs 5x more (0.05 vs 0.01 credits per profile).

Available options:
lite,
detailed
​
include_platforms
enum<string>[]

Filter social accounts to only these platforms. Reduces payload size. Does not affect search results or costs.

Available options:
instagram,
tiktok
Example:
["instagram", "tiktok"]
​
filters
object

Response

Search results

​
items
object[]
​
filtered_total
integer

Total number of matching results in the database before pagination. Use this with has_more to display "Showing 25 of 1,247 results" in your UI.

Example:

1247

​
has_more
boolean

Whether there are more results available for pagination. If true, use the next_cursor value in your next request.

Example:

true

​
next_cursor
string

Opaque cursor for fetching the next page of results. Pass this value as the cursor query parameter. Only present when has_more is true.

Example:

"eyJpZCI6MjUsInNjb3JlIjowLjg1fQ=="