SDKs
Official SDK for integrating with the Influship API.
TypeScript / JavaScript
The official SDK is generated by Stainless with full TypeScript types.
Installation
Quick Start
import Influship from 'influship';
const client = new Influship({
apiKey: process.env.INFLUSHIP_API_KEY
});
// Search for creators
const results = await client.creators.search({
query: 'fitness influencers with high engagement',
limit: 10
});
console.log(results.items);
Common Operations
Search Creators
Get Creator Details
Lookalike Search
Autocomplete
const results = await client.creators.search({
query: 'sustainable fashion creators',
filters: {
platform_filters: [{
platform: 'instagram',
min_followers: 10000,
min_engagement_rate: 3.0
}]
},
limit: 25
});
results.items.forEach(creator => {
console.log(creator.name, creator.match.score);
});
const creators = await client.creators.retrieve({
creator_ids: ['550e8400-e29b-41d4-a716-446655440000'],
mode: 'detailed',
include_profiles: true,
profile_mode: 'detailed'
});
console.log(creators.creators[0].profiles);
const lookalikes = await client.lookalike.find({
seeds: [
{ id: '550e8400-e29b-41d4-a716-446655440000' }
],
limit: 20
});
for (const creator of lookalikes.items) {
console.log(`${creator.name}: ${creator.similarity.score}`);
}
const suggestions = await client.creators.autocomplete({
q: 'sarah',
limit: 5
});
suggestions.items.forEach(s => {
console.log(`${s.name} (@${s.username})`);
});
Error Handling
import Influship, { APIError, RateLimitError } from 'influship';
try {
const results = await client.creators.search({
query: 'fitness'
});
} catch (error) {
if (error instanceof RateLimitError) {
console.log('Rate limited, retry after:', error.retryAfter);
} else if (error instanceof APIError) {
console.log('API error:', error.message);
console.log('Status:', error.status);
} else {
throw error;
}
}
TypeScript Types
The SDK includes full TypeScript definitions:
import type {
SearchRequest,
SearchResponse,
Creator,
Profile,
LookalikeRequest,
LookalikeResponse
} from 'influship';
// All request/response types are exported
const searchParams: SearchRequest = {
query: 'fitness',
limit: 10
};
Python SDK
Coming soon. For now, use the REST API directly with requests or httpx:
import requests
API_KEY = 'your_api_key'
response = requests.post(
'https://api.influship.com/v1/search',
headers={'X-API-Key': API_KEY},
json={
'query': 'fitness influencers',
'limit': 10
}
)
results = response.json()
print(results['items'])
import httpx
async def search_creators():
async with httpx.AsyncClient() as client:
response = await client.post(
'https://api.influship.com/v1/search',
headers={'X-API-Key': API_KEY},
json={
'query': 'fitness influencers',
'limit': 10
}
)
return response.json()
Interactive Examples
See the API Reference for interactive examples of every endpoint with code snippets in multiple languages.
The API Reference includes an interactive playground where you can test endpoints directly from the docs.
