> ## 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.

# x402 Payments

> Use the Influship API with USDC on Base, per-request, no signup

The Influship API supports the [x402 payment protocol](https://www.x402.org/) on its paid public data endpoints, so AI agents can pay per-request in USDC on Base without an API key, account, or billing setup.

| Before you start | Details |
| - | - |
| Auth | USDC payment proof; no API key |
| Resource | The supported endpoints listed below |
| Cost | Requested limits determine the quote; settlement is nonrefundable |
| Limits | Read the quote and cap before authorizing payment |

## How it works

1. Your agent makes a request to a supported paid 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.

`PAYMENT-SIGNATURE` is the current x402 v2 header. Influship also accepts `X-PAYMENT` for compatibility with x402 clients that still emit the earlier header name.

Once settlement succeeds, the payment is final, including when the endpoint response is an error. Successful settlement is reported in the `PAYMENT-RESPONSE` header.

## Pricing

x402 prices include a 20% surcharge over API-key/OAuth prices, rounded up to whole cents with a \$0.01 minimum. See the [API-key/OAuth price table](/concepts/pricing) to compare costs.

| Endpoint | Price |
| - | - |
| `POST /v1/search` | \$0.3000 + \$0.0240 × requested\_limit, rounded up to the next whole cent with a \$0.01 minimum (capped at 100 results) |
| `GET /v1/creators/:id` | \$0.0100 |
| `GET /v1/creators/autocomplete` | \$0.0100 |
| `POST /v1/creators/lookalike` | \$0.0180 × requested\_limit, rounded up to the next whole cent with a \$0.01 minimum (capped at 100 results) |
| `POST /v1/creators/match` | \$0.0120 × creators\_in\_request, rounded up to the next whole cent with a \$0.01 minimum |
| `GET /v1/raw/instagram/post/:shortcode` | \$0.0200 |
| `GET /v1/raw/instagram/transcript/:shortcode` | \$0.0600 |
| `GET /v1/raw/tiktok/profile/{username}` | \$0.0100 |
| `GET /v1/raw/tiktok/profile/{username}/videos` | \$0.0100 |
| `GET /v1/raw/tiktok/video` | \$0.0100 |
| `GET /v1/raw/tiktok/video/comments` | \$0.0100 |
| `GET /v1/raw/tiktok/video/comment/replies` | \$0.0100 |
| `GET /v1/raw/tiktok/music` | \$0.0100 |
| `GET /v1/raw/tiktok/video/captions` | \$0.0100 |
| `GET /v1/raw/tiktok/video/transcript` | \$0.0300 |
| `GET /v1/raw/youtube/channel/{handle}` | \$0.0100 |
| `GET /v1/raw/youtube/transcript/{video_id}` | \$0.0100 |
| `GET /v1/raw/youtube/channel-transcripts/{handle}` | \$0.0060 × requested video\_limit, rounded up to the next whole cent |
| `GET /v1/raw/youtube/search` | \$0.0100 per fetched page |
| `GET /v1/raw/youtube/video/{video_id}` | \$0.0100 |
| `GET /v1/raw/youtube/typeahead` | \$0.0100 |
| `GET /v1/raw/*` | starts at \$0.0100 unless the endpoint cost is higher |

The quote is based on your requested limit or batch size. A search returning fewer creators keeps the same quoted price.

## Quickstart

Use any x402-compatible client. The Coinbase SDK is the reference:

```bash theme={null}
npm install @x402/fetch @x402/evm viem
```

```typescript theme={null}
import { x402Client, wrapFetchWithPayment } from '@x402/fetch';
import { registerExactEvmScheme } from '@x402/evm/exact/client';
import { privateKeyToAccount } from 'viem/accounts';

const signer = privateKeyToAccount(process.env.EVM_PRIVATE_KEY as `0x${string}`);
const client = new x402Client();
registerExactEvmScheme(client, { signer });

const fetchWithPayment = wrapFetchWithPayment(fetch, client);

const response = await fetchWithPayment('https://api.influship.com/v1/search', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ query: 'fitness creators in NYC', limit: 25 }),
});

const data = await response.json();
```

Or use [AgentCash](https://agentcash.dev) for a turnkey CLI wallet:

```bash theme={null}
npx agentcash@latest discover https://api.influship.com
```

## Discovery

Influship endpoints are listed in the [x402 Bazaar](https://docs.cdp.coinbase.com/x402/bazaar). Search for "Influship" or "influencer search" to discover them programmatically.

## Need higher rate limits or volume pricing?

Get an [API key](/guides/authentication) — same endpoints, lower per-request cost, and per-tier rate limits.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.