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 x402 payment protocol, so AI agents can pay per-request in USDC on Base — no API key, no account, no billing setup.

​
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 PAYMENT-REQUIRED header containing the price and payment instructions.
  3. Your agent signs a USDC payment on Base and retries the request with a PAYMENT-SIGNATURE header.
  4. The API verifies the payment, runs the request, and settles the payment on-chain.

​
Pricing

x402 prices include a 20% surcharge over the credit-based pricing — the “x402 tax” covers settlement costs. For high-volume use, an API key is cheaper.
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)
GET /v1/creators/autocomplete\$0.000006 (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, not what we deliver. If a search returns fewer creators than requested, the price still reflects the requested cap.

​
Quickstart

Use any x402-compatible client. The Coinbase SDK is the reference: 
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,
});

const data = await response.json();
Or use AgentCash for a turnkey CLI wallet: 
npx agentcash@latest discover https://api.influship.com

​
Discovery

Influship endpoints are listed in the x402 Bazaar. Search for “Influship” or “influencer search” to discover them programmatically.

​
Need higher rate limits or volume pricing?

Get an API key — same endpoints, lower per-request cost, and per-tier rate limits.