Skip to main content
GET
/
v1
/
creators
/
autocomplete
import InflushipAPI from 'influship';

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

const response = await client.creators.autocomplete({ q: 'fitness' });

console.log(response.count);
{
"ok": true,
"count": 3,
"results": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Sarah Fitness",
"avatar": "https://cdn.influship.com/avatars/sarah.jpg",
"platforms": [
{
"platform": "instagram",
"username": "sarah_fitness",
"display_name": "Sarah | Fitness Coach",
"match_type": "username",
"match_field": "sarah_fitness"
},
{
"platform": "tiktok",
"username": "sarahfitness",
"display_name": "Sarah Fitness",
"match_type": "username",
"match_field": "sarahfitness"
}
]
},
{
"id": "234f5678-f90c-23e4-b567-537725285111",
"name": "Fit Mom Life",
"avatar": "https://cdn.influship.com/avatars/fitmom.jpg",
"platforms": [
{
"platform": "instagram",
"username": "fitmom_life",
"display_name": "Fit Mom | Wellness",
"match_type": "name",
"match_field": "Fit Mom Life"
}
]
},
{
"id": "345g6789-g01d-34f5-c678-648836396222",
"name": "Fitness Journey",
"avatar": "https://cdn.influship.com/avatars/journey.jpg",
"platforms": [
{
"platform": "instagram",
"username": "my_fitness_journey",
"display_name": "Fitness Journey Daily",
"match_type": "display_name",
"match_field": "Fitness Journey Daily"
}
]
}
]
}

Authorizations

X-API-Key
string
header
required

API key for authentication

Query Parameters

q
string
required

Search query text (partial name/username)

Required string length: 2 - 100
Example:

"fitness"

platform
enum<string>

Filter results to only show creators that have profiles on this specific platform. If not provided, returns creators from all platforms.

Available options:
instagram,
tiktok
limit
integer
default:5

Maximum number of results to return

Required range: 1 <= x <= 10
scope
enum<string>
default:all_platforms

Control the granularity of returned data

Available options:
creator_only,
matched_platforms,
all_platforms

Response

Autocomplete results

ok
boolean
count
integer
results
object[]