Skip to main content

Documentation Index

Fetch the complete documentation index at: https://socialintel.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
0. Try it free (no payment)

Before setting up a wallet, verify the API works with ?demo=true: 
curl "https://socialintel.dev/v1/search?query=fitness&demo=true"
Returns 3 cached results instantly. No USDC, no signup.
Building with an AI agent? Skip the wallet setup entirely — use AgentCash. It handles wallet, USDC, and x402 payment automatically:
npx agentcash@latest add https://socialintel.dev
Your agent (Claude, GPT, Cursor, etc.) can then call fetch("https://socialintel.dev/v1/search?category=Fitness&limit=10") and AgentCash pays automatically. Learn more →

​
1. Install an x402 client

The x402 protocol handles payment automatically. Install a client for your language: 
pip install "x402[httpx,evm]"
You’ll need a wallet with USDC on Base. The x402 client uses your private key to sign payment transactions automatically.

​
2. Make a request

import asyncio
from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

async def main():
    private_key = "0xYOUR_PRIVATE_KEY"  # EVM wallet with USDC on Base
    account = Account.from_key(private_key)

    client = x402Client()
    register_exact_evm_client(client, EthAccountSigner(account))

    async with x402HttpxClient(client) as http:
        response = await http.get(
            "https://socialintel.dev/v1/search",
            params={"category": "Fitness", "country": "US", "limit": 10}
        )
        data = response.json()
        print(f"Found {data['count']} influencers")
        for user in data["results"]:
            print(f"  @{user['username']} — {user.get('public_email', 'no email')}")

asyncio.run(main())

​
3. Inspect the response

{
  "results": [
    {
      "username": "fitnessguru",
      "full_name": "Alex Fitness",
      "followers": 150000,
      "following": 900,
      "category": "Fitness",
      "bio": "Personal trainer | Online coaching | NYC",
      "public_email": "alex@fitnessguru.com",
      "is_verified": false,
      "is_business": true
    }
  ],
  "count": 1
}
Each result includes the influencer’s profile data, follower count, business category, bio, and — for business accounts — their public contact email (~50% of business accounts have a public email).

​
What just happened?

  1. Your client sent a GET request to /v1/search
  2. The API responded with HTTP 402 and payment details (amount, wallet, chain)
  3. Your x402 client automatically paid $0.10 USDC on Base
  4. The API returned the search results
The entire payment flow is invisible to your code — the x402 client handles it.

​
Next steps

Full Parameters

All available search filters

Response Schema

Every field in the response

Code Examples

Python, Node.js, curl, and AgentCash

Pricing

Dynamic pricing formula