ECcompass E-Commerce Intelligence
Search and analyze 14,000,000+ e-commerce domains via the ECcompass REST API.
Covers GMV revenue, traffic, social media (6 platforms with 30d/90d trends), product catalog, technology stack, geographic location, contact info, and more.
Setup
- Sign up at https://eccompass.ai
- Go to Dashboard → API Access → Create Token
- Set the environment variable:
export APEX_TOKEN="your_token_here"
Quick Start
Option 1: Python Script (Recommended)
# Search e-commerce sites by keyword
python3 {baseDir}/scripts/query.py search "pet food"
python3 {baseDir}/scripts/query.py search "ooni" --page 1 --size 10
# Get full analytics for a specific domain
python3 {baseDir}/scripts/query.py domain ooni.com
python3 {baseDir}/scripts/query.py domain ooni.com --json
Option 2: curl
Search by keyword:
curl -s -H "APEX_TOKEN: $APEX_TOKEN" \
"https://api.eccompass.ai/public/api/v1/search/pet%20food?page=1&size=20"
Get domain details:
curl -s -H "APEX_TOKEN: $APEX_TOKEN" \
"https://api.eccompass.ai/public/api/v1/domain/ooni.com"
API Endpoints
1. Keyword Search — GET /public/api/v1/search/{keyword}
Searches across domain, title, description, tags, and categories. Results ranked by relevance weighted by GMV.
| Parameter | Location | Default | Description |
|---|---|---|---|
keyword |
path | — | Search keyword (required) |
page |
query | 1 | Page number, starts from 1 |
size |
query | 20 | Results per page, max 100 |
Returns summary fields per record: domain, merchantName, title, description, categories, countryCode4, platform, estimatedMonthlySales, gmv2023–gmv2026, gmvLast12month, growth
2. Domain Analytics — GET /public/api/v1/domain/{domain}
Returns 100+ fields of comprehensive e-commerce analytics for a single domain.
| Parameter | Location | Description |
|---|---|---|
domain |
path | Domain name (without http:// or www.) |
Field categories: basic info, traffic & ranking, GMV revenue (2023–2026), products, social media (6 platforms + 30d/90d trends), tech stack, geography, contact info, reviews.
Common Use Cases
| Goal | Command |
|---|---|
| Find sites in a product category | query.py search "pet food" |
| Look up a specific domain | query.py domain nike.com |
| Paginated keyword search | query.py search "coffee" --page 2 --size 50 |
| Competitor analysis | Search to discover competitors, then get details for each |
| Export raw JSON for processing | query.py domain ooni.com --json |
Error Codes
| HTTP Status | Meaning |
|---|---|
| 400 | Bad request / domain not found |
| 429 | Monthly API call limit exceeded |
Reference
- Full response schema and field definitions: references/schema.md
- Usage examples with sample output: references/examples.md
