# Social Intel API

> Find Instagram influencers by niche, engagement rate, and follower count. Pay-per-search with x402 (USDC on Base). No API keys. No subscriptions.

## How to use
- API: https://api.socialintel.dev
- Docs: https://api.socialintel.dev/docs
- Pricing: $0.10 per search (x402 micropayment)
- MCP Server: connect via mcp_server.py for direct tool access
- Agent Card: https://api.socialintel.dev/.well-known/agent-card.json

## Endpoints
- GET /v1/search — Search Instagram influencers by keyword, category, demographics, or location.

## Parameters
- query (string): Text search by name or keyword
- country (string): Country code (US, UK, DE, etc)
- category (string): Business category (Beauty, Fitness, Tech, etc)
- gender (string): "male" or "female"
- min_followers (integer): Minimum follower count (0 to 1,000,000,000)
- limit (integer): Max results (1-50, default 20)

## Quick Start (x402 Protocol)
1. Send GET request to /v1/search with query parameters
2. Receive 402 Payment Required with payment instructions in response body
3. Pay $0.10 USDC on Base chain to seller wallet: 0xB1Acd9E0269023546074400A434e703B646AaBBa
4. Resend request with x-payment header containing payment proof
5. Receive JSON results

## Response Format
```json
{"results": [{"username": "fitnessguru", "followers": 150000, "category": "Fitness"}], "count": 1}
```

## Use Cases
- Find micro-influencers for AI/crypto/fintech brands
- Lead generation for B2B outreach
- Competitor audience research

## MCP Server
Available as an MCP server for AI agent integration. Add to your MCP config:
```json
{"mcpServers": {"social-intel": {"command": "python", "args": ["mcp_server.py"], "env": {"SOCIAL_INTEL_API_URL": "https://api.socialintel.dev"}}}}
```