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.

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

  1. Your agent makes a request to any Influship API endpoint without an X-API-Key header.
  2. The API responds with 402 Payment Required and a WWW-Authenticate: Payment ... header advertising the supported MPP methods.
  3. Your agent attaches an Authorization: Payment <credential> header proving payment authorization (signed by the user’s wallet or backed by a Stripe SPT).
  4. 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.
EndpointPrice
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

RailMethodSettlement
Stripe cardstripe/chargeStripe SPT (Shared Payment Token), USD via card or Link
USDC on Tempotempo/chargeOn-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 MPPEither — pick based on rail availability
Only MPPMPP (this guide)
Only x402x402 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.