cURL
curl --request GET \
--url https://api.influship.com/v1/creators/autocomplete \
--header 'X-API-Key: <api-key>'import Influship from 'influship';
const client = new Influship({
apiKey: process.env['INFLUSHIP_API_KEY'], // This is the default and can be omitted
});
const response = await client.creators.autocomplete({ q: 'fitness' });
console.log(response.data);import requests
url = "https://api.influship.com/v1/creators/autocomplete"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Jane Fitness",
"avatar": "https://cdn.example.com/avatars/jane.jpg",
"platforms": [
{
"platform": "instagram",
"username": "fitness_coach_jane",
"display_name": "Jane Fitness",
"match_type": "username",
"match_field": "fitness_coach_jane"
}
]
}
]
}{
"error": {
"code": "validation_error",
"message": "Invalid value for parameter 'limit': must be between 1 and 100",
"param": "limit",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "unauthorized",
"message": "API key missing or invalid",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "payment_required",
"message": "Payment authentication is required.",
"status_code": 402,
"reason_code": "PAYMENT_ACTION_REQUIRED",
"next_step": "complete_authentication",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "forbidden",
"message": "Your plan does not include access to this endpoint",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded (per minute)",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "internal_error",
"message": "An unexpected error occurred. Please try again later.",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "service_unavailable",
"message": "Live Instagram data is temporarily unavailable. Please retry shortly.",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {
"retry_after_seconds": 60,
"upstream_error": "upstream_rate_limited"
}
}
}Creators
Autocomplete Search
Find creators by name or username as a user types. Results identify the matching field and value.
Matching behavior:
- Matches against creator name, username, and display name
- Results include which field matched and the matching value
- Prefix matching (e.g., “fit” matches “fitness_coach”)
Scope options:
creator_only: Return only the creator entitymatched_platforms: Return only profiles that matched the queryall_platforms: Return all linked profiles on supported API platforms (currently Instagram; default)
Also callable as the autocomplete_creators MCP tool — see the MCP server guide for setup.
Pricing: 0.05 credits per request ($0.0005)
GET
/
v1
/
creators
/
autocomplete
cURL
curl --request GET \
--url https://api.influship.com/v1/creators/autocomplete \
--header 'X-API-Key: <api-key>'import Influship from 'influship';
const client = new Influship({
apiKey: process.env['INFLUSHIP_API_KEY'], // This is the default and can be omitted
});
const response = await client.creators.autocomplete({ q: 'fitness' });
console.log(response.data);import requests
url = "https://api.influship.com/v1/creators/autocomplete"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Jane Fitness",
"avatar": "https://cdn.example.com/avatars/jane.jpg",
"platforms": [
{
"platform": "instagram",
"username": "fitness_coach_jane",
"display_name": "Jane Fitness",
"match_type": "username",
"match_field": "fitness_coach_jane"
}
]
}
]
}{
"error": {
"code": "validation_error",
"message": "Invalid value for parameter 'limit': must be between 1 and 100",
"param": "limit",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "unauthorized",
"message": "API key missing or invalid",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "payment_required",
"message": "Payment authentication is required.",
"status_code": 402,
"reason_code": "PAYMENT_ACTION_REQUIRED",
"next_step": "complete_authentication",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "forbidden",
"message": "Your plan does not include access to this endpoint",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded (per minute)",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "internal_error",
"message": "An unexpected error occurred. Please try again later.",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "service_unavailable",
"message": "Live Instagram data is temporarily unavailable. Please retry shortly.",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {
"retry_after_seconds": 60,
"upstream_error": "upstream_rate_limited"
}
}
}