Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.influship.com/llms.txt

Use this file to discover all available pages before exploring further.

​
What’s New

​
May 2026
Feature

​
Raw Instagram post lookup and transcripts

You can now look up an individual Instagram post by shortcode and fetch video transcripts directly from the raw API. These endpoints return fresh raw post data, including fields that are not guaranteed on cached post-list responses, such as coauthors, paid partnership flags, tagged users, product mentions, display resources, video versions, music attribution, and location data.Available endpoints:
  • GET /v1/raw/instagram/post/{shortcode} for one post
  • POST /v1/raw/instagram/posts for up to 20 posts in one request
  • GET /v1/raw/instagram/transcript/{shortcode} for one video post transcript
  • POST /v1/raw/instagram/transcripts for up to 10 video post transcripts in one request
Transcript responses include the post lookup payload, so you do not need a separate post request before transcribing a Reel or video post.We’ve also added two Apify actors for no-code and workflow use cases:
  • Instagram Post Lookup
  • Instagram Post Transcripts
Both actors use your Influship API key and mirror the raw API response shapes.
​
May 2026
Feature

​
MCP Server

The Influship MCP server is live at mcp.influship.com/mcp. Connect any Model Context Protocol-compatible client — Claude Desktop, Claude Code, Cursor, Windsurf, ChatGPT Connectors, VS Code — and the API surfaces as eight typed tools the agent can call directly.
claude mcp add influship --transport http https://mcp.influship.com/mcp --header "X-API-Key: YOUR_KEY"
Or paste the JSON config into your client’s MCP settings panel:
{
  "mcpServers": {
    "influship": {
      "url": "https://mcp.influship.com/mcp",
      "headers": { "X-API-Key": "YOUR_KEY" }
    }
  }
}
Auth, billing, and rate limits are all the same as the REST API — same key, same tier, same dashboard. There’s no separate “MCP plan” to set up.See the MCP Server guide for the full setup walkthrough and the tool reference (each REST endpoint with an MCP equivalent now shows the corresponding tool name).
​
May 2026
Feature

​
Pay per request with x402 (no API key needed)

Anonymous AI agents can now hit any Influship endpoint via the x402 payment protocol. The agent makes a request without an X-API-Key, gets a 402 Payment Required back with a USDC-on-Base price, signs a payment, and retries — all in seconds, no signup, no billing setup.
import { fetchWithX402 } from '@coinbase/x402';

const response = await fetchWithX402('https://api.influship.com/v1/search', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ query: 'fitness creators in NYC', limit: 25 }),
  wallet: yourBaseWallet,
});
Influship endpoints are listed in the x402 Bazaar for programmatic discovery. See the x402 guide for pricing and quickstart with AgentCash or the Coinbase SDK.
​
May 2026
Feature

​
Pay with MPP (Stripe cards or USDC on Tempo)

The Machine Payments Protocol — Stripe and Tempo’s open standard for HTTP-native machine-to-machine payments — coexists with x402 on the same endpoints. Pay per request via Stripe SPT (Shared Payment Tokens, USD via card) or USDC on Tempo. Pick whichever rail your client supports; the API accepts both.
import { Mppx, stripe } from 'mppx/client';

const mppx = Mppx.create({
  methods: [stripe({ stripe: yourStripeClient })],
});

const response = await fetch('https://api.influship.com/v1/search', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ query: 'fitness creators in NYC', limit: 25 }),
}).then((r) => mppx.handle(r));
See the MPP guide for both rails. Same pricing as x402.
​
March 2026
Feature

​
Weighted lookalike seeds

Lookalike search now accepts up to 10 seeds with individual weights (0-1). Higher weights make the API lean more heavily on that seed’s characteristics when ranking results.This is particularly useful when you have campaign performance data — weight your best performers higher and the API finds more creators who skew toward that profile.
{
  "seeds": [
    { "platform": "instagram", "username": "top_performer", "weight": 1.0 },
    { "platform": "instagram", "username": "decent_creator", "weight": 0.5 }
  ],
  "limit": 25
}
See Lookalikes for weighting strategies.
​
March 2026
Improvement

​
Search billing and rate limit alignment

Search billing now cleanly separates the base fee (AI inference cost) from the per-creator delivery fee. Rate limit headers are consistent across all endpoints and accurately reflect credit consumption.
​
February 2026
Feature

​
Campaign match endpoint

POST /v1/creators/match scores creators against a campaign brief. Each result includes a decision (good, neutral, or avoid), a numeric score, and human-readable reasoning.The intent.query field (500 chars) describes the campaign. The optional intent.context field (2,000 chars) adds background — target demographics, content format preferences, brand guidelines.See Match Reasons for how to interpret the output.
​
February 2026
Improvement

​
Credit-based rate limiting with trust tiers

Rate limits are now enforced using credit budgets instead of simple request counts. Heavier endpoints consume more budget than lighter ones. Trust tiers increase your limits based on lifetime spend — and never downgrade.See Rate Limits & Tiers for the full tier table.
​
February 2026
Feature

​
TypeScript SDK via Stainless

The official TypeScript SDK is available on npm. Generated from the OpenAPI spec by Stainless, it provides typed methods, request/response models, and error classes like RateLimitError and APIError.
npm install influship
See the SDK guide for setup and common operations.
​
January 2026
Feature

​
Stripe usage billing

API usage is now billed through Stripe with automatic invoice generation. Credits accumulate until your trust tier’s billing threshold is reached, then an invoice is created. Payment upgrades your tier and increases rate limits.See Pricing for credit costs and Rate Limits & Tiers for threshold details.