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

# Pay with x402 (no API key needed)

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

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

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

| 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/*`                               | starts at `\$0.0100` unless the endpoint cost is higher                                                                  |

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:

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