# Intelica — Full Reference
> Competitive intelligence API for autonomous AI agents and founders.
> Pay-per-call via x402 on Base and Solana mainnet, API Key with pre-loaded balance, or human access plans.

## Overview

Intelica analyzes any company or market and returns structured competitive intelligence in seconds.
Built on Exa web search with real-time verified sources.
Supports 8 languages with regional market context (keiretsu, chaebol, BAT, Pix, RFC, CPF, CUIT).

**Base URL:** https://api.intelica.dev
**Version:** 4.5.1
**Protocol:** HTTP/2 + x402 v1

## Authentication — Three Methods

### Method 1: X-PAYMENT (x402 — autonomous agents with wallet)
Agents pay $0.05 USDC per call autonomously. No setup required if agent has x402-compatible wallet.

Step 1 — Get payment challenge:
```
GET https://api.intelica.dev/intel
→ HTTP 402 Payment Required
→ Body contains accepts[] with Base and Solana payment options
```

Step 2 — Pay on Base mainnet:
```python
payment_token = wallet.sign_x402_payment(
    payTo="0x1d6bA7ac2461fd0E17D6A4C7bc1c9Ce365EfC4FF",
    amount=50000,  # $0.05 USDC (6 decimals)
    asset="0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    network="base-mainnet",
    resource="https://api.intelica.dev/intel"
)
```

Step 2 — Pay on Solana mainnet:
```python
payment_token = wallet.sign_x402_payment(
    payTo="45q8KyCAGSHHd6qYP2ZkEJh22SzeQeXRfyFsENcx3KN6",
    amount=50000,
    asset="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    network="solana-mainnet",
    resource="https://api.intelica.dev/intel"
)
```

Step 3 — Call /intel:
```python
response = httpx.post(
    "https://api.intelica.dev/intel",
    headers={"X-PAYMENT": payment_token},
    json={"text": "Notion workspace productivity tool", "mode": "competitive"}
)
```

### Method 2: X-API-KEY (developers with pre-loaded balance)
Load USDC once, use across all agents without per-call wallet setup.

Create API key:
```
POST https://api.intelica.dev/access/api-key
Body: {"tx_hash": "your_solana_tx", "amount_usdc": 10.0, "email": "optional"}
Response: {"api_key": "sk-intelica-...", "calls_available": 200, "balance_usdc": 10.0}
```

Use API key:
```
POST https://api.intelica.dev/intel
Headers: {"X-API-KEY": "sk-intelica-...", "Content-Type": "application/json"}
Body: {"text": "company description", "mode": "competitive"}
```

Check balance:
```
GET https://api.intelica.dev/access/api-key/status?key=sk-intelica-...
Response: {"balance_usdc": 9.95, "calls_remaining": 199, "calls_made": 1}
```

### Method 3: X-SESSION (human access plans)
Human founders buy plans. Starter $15 USDC / 30 reports / 10 days. Pro $30 USDC / 100 reports / 30 days.

```
POST https://api.intelica.dev/access/activate
Body: {"plan": "pro", "tx_hash": "your_solana_tx"}
Response: {"session_id": "...", "reports_total": 100, "duration_days": 30}

POST https://api.intelica.dev/intel
Headers: {"X-SESSION": "your-session-id"}

GET https://api.intelica.dev/access/status?session=your-session-id
Response: {"reports_remaining": 99, "expires_at": "...", "status": "active"}
```

## Core Endpoint — POST /intel

**Request:**
```json
{
  "text": "Company name or description (min 50 chars)",
  "url": "https://competitor.com (alternative to text)",
  "mode": "competitive",
  "format": "json",
  "context": "optional extra context",
  "force_refresh": false,
  "operator_id": "optional-agent-id"
}
```

**Response:**
```json
{
  "source": "provided_text",
  "analysis": {
    "company_or_product": "Notion",
    "positioning_summary": "...",
    "target_customer": "...",
    "core_value_props": ["..."],
    "user_pain_points": ["..."],
    "detected_competitors": ["Asana", "ClickUp", "Atlassian"],
    "unique_angle": "...",
    "market_score": {
      "threat_level": "high",
      "moat_strength": 0.72,
      "market_maturity": "mature",
      "agent_recommendation": "counter"
    },
    "sources": ["https://...", "https://...", "https://..."],
    "market_signals": {
      "headcount_signal": "1000 employees",
      "pricing_signal": "$9/user",
      "recent_coverage": "3 recent articles"
    }
  },
  "cached": false,
  "response_ms": 6309,
  "price_paid_usdc": "0.05",
  "mode": "competitive",
  "detected_language": "en",
  "market_context": "global"
}
```

## Analysis Modes

| Mode | Price | Description |
|------|-------|-------------|
| competitive | $0.05 | Market positioning, pain points, competitors, unique angle |
| market_entry | $0.05 | Market gaps, saturation, barriers to entry |
| fundraising | $0.05 | Investor narrative, TAM, traction signals |
| partnership | $0.05 | Strategic fit, complementarity, risk signals |
| acquisition | $0.05 | Moat strength, technical risks, acquisition thesis |
| crypto_protocol | $0.05 | DeFi moat, tokenomics, regulatory risk |
| sales_enablement | $1.00 | Full battlecard + objection handler |
| venture_screening | $1.00 | Investment thesis, deal-breakers, position |
| regulatory_compliance | $1.00 | EU AI Act, GDPR, HIPAA exposure |
| risk_assessment | $1.00 | Business model stability, operational risk |

## agent_recommendation Values

- **counter** — compete directly, you have a clear angle
- **monitor** — watch but don't engage yet
- **partner** — better to collaborate than compete
- **avoid** — market too saturated or moat too strong
- **acquire** — acquisition opportunity detected

## Additional Endpoints

### Free Demo (no payment)
```
POST https://api.intelica.dev/demo
Body: {"text": "company description", "mode": "competitive"}
Limit: 1 call per IP
Returns: positioning_summary + market_score only (competitors locked)
```

### Batch Analysis
```
POST https://api.intelica.dev/batch
Headers: {"X-PAYMENT": payment_token}  — $0.20 USDC for up to 5 companies
Body: {"companies": ["Notion", "Asana", "ClickUp"], "mode": "competitive"}
```

### Competitive Graph
```
GET https://api.intelica.dev/graph?company=Notion
Returns: nodes and edges of competitive relationships
```

### MCP Server
```
POST https://api.intelica.dev/mcp
Protocol: JSON-RPC 2.0
Tools: intel_analyze, intel_demo, intel_api_key_create, intel_api_key_status
```

## Payment Details

| Network | Asset | Wallet | Price |
|---------|-------|--------|-------|
| Base mainnet | USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) | 0x1d6bA7ac2461fd0E17D6A4C7bc1c9Ce365EfC4FF | $0.05 |
| Solana mainnet | USDC (EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v) | 45q8KyCAGSHHd6qYP2ZkEJh22SzeQeXRfyFsENcx3KN6 | $0.05 |

## Discovery Endpoints

- `GET /llms.txt` — Agent discovery (this file, compact version)
- `GET /llms-full.txt` — Full reference (this file)
- `GET /openapi.json` — OpenAPI 3.0 schema
- `GET /.well-known/ai-plugin.json` — OpenAI plugin manifest
- `GET /.well-known/mcp.json` — MCP client auto-configuration
- `GET /.well-known/pay.json` — x402 payment configuration
- `GET /.well-known/agent.json` — A2A agent card
- `GET /health` — Health check
- `GET /robots.txt` — Crawler instructions

## Error Responses

| Code | Error | Meaning |
|------|-------|---------|
| 402 | payment_required | No payment header provided |
| 401 | invalid_session | Session key not found |
| 401 | invalid_api_key | API key not found |
| 402 | access_expired | Plan expired |
| 402 | access_exhausted | Report limit reached |
| 402 | insufficient_balance | API key balance too low |
| 422 | not_enough_content | Text too short (min 50 chars) |
| 429 | rate_limit_exceeded | Demo limit reached (1/IP) |

## Resources

- OpenAPI: https://api.intelica.dev/openapi.json
- MCP server: https://api.intelica.dev/mcp
- Human access: https://teodorofodocrispin-cmyk.github.io/Intelica-docs/intelica.html
- Free demo: https://teodorofodocrispin-cmyk.github.io/Intelica-docs/try.html
- GitHub: https://github.com/teodorofodocrispin-cmyk/Intelica-docs