samrothschild23/intelligence-api

An x402-powered intelligence API for Shopify, Amazon, and Google Maps data. AI agents pay per call in USDC on Base — no signup, no API keys, no human in the loop.
What This Does
| Tool | What It Returns | Price |
|------|----------------|-------|
| GET /shopify/analyze | Products, pricing, apps, theme, collections for any Shopify store | $0.08 |
| GET /shopify/products | Paginated product catalog from any Shopify store | $0.02 |
| GET /amazon/search | Amazon search results with Opportunity Score | $0.05 |
| GET /amazon/product | Single ASIN analysis with FBA profitability estimate | $0.08 |
| GET /maps/search | Google Maps business search with Lead Quality Score | $0.05 |
| GET /maps/leads | Qualified sales leads with outreach hints | $0.10 |
Free endpoints: GET /health, GET /.well-known/mcp.json, GET /openapi.json
---
How x402 Payment Works
x402 is a protocol for machine-native micropayments using HTTP 402. No accounts, no rate-limit keys, no billing — agents pay per call in USDC on Base.
**Flow:**
Agents need a funded Base wallet with USDC. USDC settles directly to the server wallet — no intermediary, no escrow.
---
Endpoints
GET /shopify/analyze
Analyzes a Shopify store: product catalog, pricing distribution, top vendors, product types, detected apps (Klaviyo, Yotpo, ReCharge, etc.), theme detection.
**Query params:**
- url (required) — store URL, e.g. example.myshopify.com
**Example:**
**Response:**
---
GET /shopify/products
Paginated product catalog. Pages up to 250 products per call.
**Query params:**
- url (required)
- page (optional, default: 1)
- limit (optional, default: 50, max: 250)
---
GET /amazon/search
Searches Amazon products and returns an **Opportunity Score** (0–100) for each. High score = strong demand + quality gap + good price tier.
**Query params:**
- keyword (required)
- marketplace (optional: US | UK | DE | CA | AU, default: US)
**Example:**
**Response:**
**Opportunity Score formula:**
- Reviews >1000 (proven demand): +15
- Rating 50: +10–15
- Price level ≥2: +10
- Business OPERATIONAL: +10
---
GET /maps/leads
Returns only businesses above a quality score threshold, sorted by score. Best for building targeted outreach lists.
**Query params:**
- industry (required)
- location (required)
- min_score (optional, default: 60)
- google_key (required)
---
Getting a Google Places API Key
Maps endpoints require your own Google Places API key (the server never stores it):
1. Go to console.cloud.google.com
2. Create or select a project
3. Enable **Places API**
4. Create an API key under **APIs & Services → Credentials**
5. Pass it as ?google_key=YOUR_KEY on every Maps request
---
Agent Discovery
x402scan
Agents discover x402-enabled APIs via x402scan. The server returns proper x402 headers on every 402 response.