API Reference

Overview

Social Intel API is a REST API for discovering Instagram influencers. It uses the x402 payment protocol — each request requires a one-time micropayment of $0.10 USDC. No API key registration or monthly subscription is needed.

The API is designed for AI agents, marketing platforms, and developers who need on-demand influencer data. Payments are accepted on Base, Ethereum, BNB Chain, and Solana.

Base URL: https://socialintel.dev
Protocol: HTTPS only
Format: JSON responses
Auth: x402 micropayment per request (no API key required)

Endpoint: Search Influencers

GET /v1/search $0.10 per request

Search Instagram influencer profiles. Returns up to 50 results filtered by keyword, category, location, gender, or follower count. Results are sorted by follower count (descending).

Query Parameters

Parameter	Type	Required	Description
query	string	optional	Free-text search by username or keyword. Example: `fitness coach`, `beauty`
country	string	optional	Country code filter. Use 2-letter ISO codes: `US`, `GB`, `DE`, `FR`, `BR`, etc.
category	string	optional	Business category filter. Examples: `Beauty`, `Fitness`, `Tech`, `Food`, `Travel`, `Fashion`
gender	string	optional	Gender filter. Accepted values: `male` or `female`
min_followers	integer	optional	Minimum follower count. Example: `10000` for 10k+ followers. Range: 0–1,000,000,000
max_followers	integer	optional	Maximum follower count — applied server-side for micro-influencer discovery. Combine with `min_followers` to target specific ranges (e.g. 10K–100K).
limit	integer	optional	Number of results to return. Default: `20`. Min: `1`, Max: `50`

Note: At least one filter parameter is recommended for meaningful results. All filters — including max_followers, category, country, and gender — are applied server-side. Combine min_followers and max_followers for precise micro-influencer targeting (e.g. 10K–100K).

Example Requests

Search by keyword:

GET https://socialintel.dev/v1/search?query=fitness+coach&limit=10

US female fitness influencers, 10k–500k followers:

GET https://socialintel.dev/v1/search?country=US&gender=female&category=Fitness&min_followers=10000&max_followers=500000&limit=20

Micro-influencers by category:

GET https://socialintel.dev/v1/search?category=Beauty&min_followers=10000&max_followers=100000&limit=50

Response Format

Returns a JSON object with a results array and a count integer.

{
  "count": 3,
  "results": [
    {
      "username": "fitnessguru",
      "full_name": "Alex Smith",
      "followers": 125000,
      "following": 980,
      "bio": "Personal trainer | Nutrition coach | DM for collabs",
      "is_verified": false,
      "is_business": true,
      "public_email": "[email protected]",
      "profile_pic_url": "https://...",
      "category": "Fitness",
      "country": "US",
      "city": "Los Angeles",
      "gender": "male"
    }
  ]
}

Response Fields

username

Instagram username (handle), without the @ sign

full_name

Display name on the Instagram profile

followers

Total follower count

following

Number of accounts followed

bio

Profile biography / description text

is_verified

Whether the account has a verified badge

is_business

Whether the account is registered as a business account

public_email

Business contact email (when publicly listed). Most valuable for outreach. Available on business accounts only.

profile_pic_url

URL to the profile picture image

x402 Payment Flow

Social Intel API uses the x402 open payment protocol. Each request to /v1/search costs $0.10 USDC. Payment is included directly in the HTTP request header — no pre-registration required.

How It Works

Initial request (no payment). Send a GET request to /v1/search. The server returns HTTP 402 Payment Required with a PAYMENT-REQUIRED header containing the payment terms: amount ($0.10), accepted networks, and facilitator URL.
Create payment. Using an x402-compatible wallet or SDK, sign a payment for $0.10 USDC on any supported network. The payment proof is submitted to the facilitator (facilitator.payai.network) which locks the funds.
Repeat request with payment. Resend the same GET request with an X-PAYMENT header containing the signed payment proof (base64-encoded JSON). The server verifies the payment and processes the search.
Response and settlement. If the payment is valid, the server returns HTTP 200 with JSON results and settles the transaction on-chain.

Supported Payment Networks

⚠️ Gas fee requirement: In addition to USDC, your wallet needs a small amount of the network's native token to pay gas fees — ETH on Base/Ethereum/BNB Chain, or SOL on Solana. A wallet with only USDC cannot send transactions. ~$0.01 of native token is sufficient.

Base

eip155:8453

USDC + ETH (gas) — recommended

Ethereum

eip155:1

USDC + ETH (gas)

BNB Chain

eip155:56

USDC + BNB (gas)

Solana

solana:mainnet

USDC + SOL (gas)

Code Example: Python (x402 SDK)

# pip install "x402[httpx,evm]"
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 search_influencers():
    account = Account.from_key("0xYOUR_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={"country": "US", "category": "Fitness",
                    "gender": "female", "min_followers": 10000, "limit": 20}
        )
        print(response.json())

asyncio.run(search_influencers())

Code Example: JavaScript / Node.js

// npm install @x402/fetch @x402/evm viem
import { x402Client, wrapFetchWithPayment } from '@x402/fetch';
import { ExactEvmScheme } from '@x402/evm/exact/client';
import { privateKeyToAccount } from 'viem/accounts';

const signer = privateKeyToAccount('0xYOUR_PRIVATE_KEY');
const client = new x402Client();
client.register('eip155:*', new ExactEvmScheme(signer));

const fetch402 = wrapFetchWithPayment(fetch, client);

const res = await fetch402(
  'https://socialintel.dev/v1/search?country=US&category=Fitness&limit=10'
);
const data = await res.json();
console.log(data.results);

Using AgentCash (AI Agent Payments)

AI agents can use AgentCash to make x402 payments automatically without managing private keys. Social Intel API is registered on the AgentCash service directory at https://socialintel.dev.

# Via AgentCash MCP tool (in Claude, Cursor, etc.)
# Discover: agentcash discover https://socialintel.dev
# Then call fetch() with the endpoint and params

HTTP Status Codes

Code	Meaning
200	Success. JSON results returned in response body.
402	Payment Required. Response includes `PAYMENT-REQUIRED` header with payment terms. Resend the request with an `X-PAYMENT` header.
429	Rate limit exceeded. Maximum 60 requests per minute per IP address. Response includes a `Retry-After` header with the number of seconds to wait.
502	Data source temporarily unavailable. Retry the request.

MCP Server (AI Agent Integration)

Social Intel API includes an MCP (Model Context Protocol) server that lets AI assistants — Claude, Cursor, and other MCP-compatible tools — search influencers directly without writing code.

MCP Endpoint

https://socialintel.dev/mcp

Available Tool: search_leads

The MCP server exposes a single tool search_leads with the same parameters as the REST endpoint above.

Connect via Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "social-intel": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://socialintel.dev/mcp"]
    }
  }
}

Or install from Smithery.