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);

{
  "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 entity
matched_platforms: Return only profiles that matched the query
all_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

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);

{
  "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"
    }
  }
}

Authorizations

X-API-Key

string

header

required

Query Parameters

string

required

Search query (min 2 characters)

Required string length: 2 - 100

Example:

"fitness"

platform

enum<string>

Filter by platform

Available options:

instagram

Example:

"instagram"

limit

integer

default:5

Maximum results to return

Required range: 1 <= x <= 50

Example:

5

scope

enum<string>

default:all_platforms

Which platforms to include in results

Available options:

creator_only,

matched_platforms,

all_platforms

Example:

"all_platforms"

Response

Successful response

data

object[]

required

Autocomplete results

Show child attributes

Overview

Endpoints

Autocomplete Search

Authorizations

Query Parameters

Response