Client Setup

Use the influship package for typed JavaScript and TypeScript requests. For other languages, call the REST API with your HTTP client. Browse the SDK on npm or GitHub. For complete apps and runnable workflows, see the cookbook.

Install the SDK

npm
yarn
pnpm
bun

npm install influship

yarn add influship

pnpm add influship

bun add influship

Configure a server-side client

Set INFLUSHIP_API_KEY in your server environment:

export INFLUSHIP_API_KEY="your_api_key_here"

import Influship from 'influship';

const client = new Influship({ maxRetries: 0 });
const search = await client.search.create({
  query: 'sustainable fashion creators who explain clothing repair',
  limit: 5,
});

for (const result of search.data) {
  console.log(result.creator.name, result.match.reasons);
}

The client reads INFLUSHIP_API_KEY automatically. You can also pass apiKey explicitly. Keep the client in a server action, route handler, backend service, or CLI; keep the key out of browser bundles and version control. Each result contains creator, profile summaries, and match. Follow the Quickstart to use a returned creator ID in a second request, or run the creator research app.

Handle typed errors

The SDK retries some failures twice by default. The example sets maxRetries: 0 so your application controls retry behavior.

import { APIError, RateLimitError } from 'influship';

try {
  await client.search.create({ query: 'clothing repair tutorials', limit: 5 });
} catch (error) {
  if (error instanceof RateLimitError) {
    console.error('Rate limited. Retry-After:', error.headers?.get('retry-after'));
  } else if (error instanceof APIError) {
    console.error(error.status, error.code, error.message);
  } else {
    throw error;
  }
}

For 429, 500, and temporary 503 responses, use bounded retries with a total deadline and honor Retry-After. For 402, check billing before sending another request. For 502 upstream_contract_broken, stop automatic retries; a source query or validation failure does not confirm account deletion. Use available cached data and contact support if the issue persists. The Error Handling guide includes the complete policy and a retry example. When merging live Instagram profile responses, treat bio_links as available valid links. Recovery excludes unusable source entries; an empty array or external_url: null does not establish that a creator removed their website. Preserve previously known website data when the new response provides no usable link. See Instagram profile metadata.

Call REST from Python

Install requests, then read the same server-side environment variable:

python -m pip install requests

import os
import requests

response = requests.post(
    'https://api.influship.com/v1/search',
    headers={'X-API-Key': os.environ['INFLUSHIP_API_KEY']},
    json={'query': 'creators who teach clothing repair', 'limit': 5},
    timeout=60,
)
response.raise_for_status()
for result in response.json()['data']:
    print(result['creator']['name'], result['match']['reasons'])

Continue with your workflow

Task	Guide
Find more creators like a reference account	Find similar creators
Evaluate known Instagram handles	Score campaign fit
Resolve profiles and read timestamps	Understanding creator data
Fetch profiles, videos, or transcripts	Live platform data
Save a selection and review notes	Saved shortlists

Set up with a coding agent

Install the Influship SDK using this project's existing conventions.

Open in Cursor

The API Reference defines method signatures and response schemas. When upgrading, compare it with your installed SDK version.

Start building

Find and evaluate creators

Research and save

Apps and workflows

Live platform data

Connect your tools

Operate your integration

Install the SDK

Configure a server-side client

Handle typed errors

Call REST from Python

Continue with your workflow

​Install the SDK

​Configure a server-side client

​Handle typed errors

​Call REST from Python

​Continue with your workflow

Install the SDK

Configure a server-side client

Handle typed errors

Call REST from Python

Continue with your workflow