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.
The Influship API supports the Machine Payments Protocol (MPP) — Stripe and Tempo’s open standard for HTTP-native machine-to-machine payments. AI agents can pay per-request via Stripe cards (Shared Payment Tokens) or USDC on Tempo, no API key required.
MPP coexists with x402 on the same endpoints. Pick whichever your client supports — we accept both.
How it works
- Your agent makes a request to any Influship API endpoint without an
X-API-Key header.
- The API responds with
402 Payment Required and a WWW-Authenticate: Payment ... header advertising the supported MPP methods.
- Your agent attaches an
Authorization: Payment <credential> header proving payment authorization (signed by the user’s wallet or backed by a Stripe SPT).
- The API verifies, runs the request, and returns the response with a
Payment-Receipt header.
The same 402 response includes both MPP and x402 challenges, so the client can pick.
Pricing
MPP prices match x402 pricing — same 20% surcharge over the credit-based pricing.
| Endpoint | Price |
|---|
POST /v1/search | \$0.0030 + \$0.00024 × requested_limit (capped at 100 results) |
GET /v1/creators/:id | \$0.000012 (rounded up to $0.01 minimum) |
POST /v1/creators/lookalike | \$0.00018 × requested_limit |
POST /v1/creators/match | \$0.00012 × creators_in_request |
GET /v1/raw/* | \$0.00006 (rounded up to $0.01 minimum) |
You pay for what you ask for — limits and array sizes determine the price, not what we deliver.
Supported rails
| Rail | Method | Settlement |
|---|
| Stripe card | stripe/charge | Stripe SPT (Shared Payment Token), USD via card or Link |
| USDC on Tempo | tempo/charge | On-chain USDC, settled in seconds |
Both are advertised in the same WWW-Authenticate header. Your client picks based on which rails it supports.
Quickstart
Use any MPP-compatible client. The reference SDK is mppx by wevm:
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));
const data = await response.json();
Or use AgentCash for a turnkey CLI wallet that speaks both x402 and MPP:
npx agentcash@latest discover https://api.influship.com
Discovery
Influship endpoints are listed in the MPP services directory. Search for “Influship” or “influencer search” to find them programmatically.
Pick your protocol
| If your agent supports… | Use |
|---|
| Both x402 and MPP | Either — pick based on rail availability |
| Only MPP | MPP (this guide) |
| Only x402 | x402 guide |
| Neither (only API keys) | Get an API key for lower per-request cost and per-tier rate limits |
Need higher rate limits or volume pricing?
Get an API key — same endpoints, lower per-request cost, no x402/MPP surcharge.