Ecommerce Website Data

Free, instant access to live data on 14M+ Ecommerce stores. Capabilities: (1) Keyword + filter search (2) Full store analytics (3) Historical ecommerce GMV &...

Security Scan

The skill is internally consistent: it's a Python CLI wrapper around the EcCompass API that legitimately requires a single APEX_TOKEN and network access to api.eccompass.ai, with no unrelated credentials, installers, or unexpected behavior in the provided files.

Purpose & Capability

Name/description, documentation, and code all describe a client for the EcCompass API. Required artifacts (python3 and an APEX_TOKEN) directly match the stated purpose; the code only calls api.eccompass.ai endpoints documented in SKILL.md and references no unrelated services or credentials.

Instruction Scope

SKILL.md instructs the agent/user to set APEX_TOKEN and to run the included Python script for searches, domain lookups, historical data, installed apps, and contacts. The runtime instructions and the script are aligned: the script uses the APEX_TOKEN env var and only issues HTTPS requests to the documented /public/api/v1/* paths. The instructions do not request reading unrelated local files or sending data to unexpected endpoints.

Install Mechanism

No install spec is provided (instruction-only with an included Python script). That is the lowest-risk pattern; nothing is downloaded or extracted from third-party URLs and no external packages are forced to install by the skill itself.

Credentials

Only a single environment variable (APEX_TOKEN) is required and is the expected API credential for the service. No other tokens, secrets, or system config paths are requested. The script reads APEX_TOKEN and uses it in the APEX_TOKEN HTTP header as documented.

Persistence & Privilege

The skill does not request permanent 'always' inclusion, does not modify other skills or system-wide agent settings, and carries only normal network permission. Autonomous invocation capability is default and not by itself concerning here.

Assessment

This skill appears to do exactly what it says: a Python CLI to query EcCompass's public API. Before installing, verify you trust eccompass.ai and only provide an API token you are willing to use for this purpose. Treat APEX_TOKEN like any API secret—do not paste it into untrusted places or share it. If you need additional assurance, review scripts/query.py locally (it is small and readable) to confirm no extra network endpoints or unexpected file access, and consider creating a token with restricted scope/rotation policy on the EcCompass dashboard. Also be aware the skill returns contact emails and other business data — ensure your use complies with your privacy and legal requirements.

Ecommerce Website Data

The All-in-One Skill for ecommerce intelligence.

Powered by EcCompass AI — one of the world's largest DTC databases — this skill delivers free, live data on 14M+ stores with 100+ analytics fields.

What You Can Do

Search Stores — "Find Shopify stores selling pet food with 10k+ Instagram followers"

Domain Analytics — "Show me ooni.com's GMV trend and tech stack"

Lead Contacts — "Get decision-maker emails for this brand"

Data Coverage

Metric	Value
Total domains	14,000,000+
Countries	200+
Platforms	Shopify, WooCommerce, Wix, Squarespace, bigcommerce and more
GMV data	Monthly GMV from 2023 to Date
Social media	Instagram, TikTok, Twitter/X, YouTube, Facebook, Pinterest
Lead Contacts	Verified LinkedIn profiles and business emails
Update frequency	Monthly

EcCompass Sub-skill Set

Prefer lightweight, focused tools? We also offer standalone Sub-Skills — install only what you need.

Important: All features below are already available in this All-in-One Skill. The "Status" column indicates standalone Sub-Skill availability.

Section	Sub-Skill	Description	Status
Site Search	Supplier Lead Filter	Filter sites by category, traffic, tech stack — surface the most qualified leads.	In dev
	Competitor Discovery	Find every player in your niche before they find you.	In dev
	Merchant Discovery	Find top-rated merchants carrying what you're looking for.	In dev
Site Analysis	Lead Contacts	Get LinkedIn profile and business email for any domain.	✅ Live
	Historical GMV	Track GMV over time — spot growth trajectories and plateaus.	In dev
	Tech Stack	Reveal plugins, themes, builders, and integrations.	In dev
	Traffic Monitor	Understand visits, page views, and peer rankings.	In dev
	Product Analysis	See categories, catalogue size, and pricing range.	In dev
	Social Media	Gauge social footprint and audience growth.	In dev
Market Analysis	Builder Platform Monitor	Track market share shifts between Shopify, WooCommerce, etc.	In dev
	Plugin Install Trends	See which plugins are gaining traction.	In dev
	Category Popularity	Spot which product categories are heating up.	In dev

Usage Notes

Data freshness — Store data is live and updated monthly, not a static snapshot.

GMV accuracy — Revenue figures are estimates based on traffic and industry benchmarks, not actual financial records.

Contact verification — All emails and LinkedIn profiles have been verified.

Scope

Can do — Store discovery, single-store analytics, competitor lookup, tech stack detection, contact extraction

Cannot do — Access store backend, guarantee exact GMV, provide real-time inventory or pricing, execute outreach campaigns.

Setup

100% Free. One-minute setup.

1. Sign up at https://eccompass.ai
2. Go to Dashboard → API Access → Create Token
3. Set the environment variable:

export APEX_TOKEN="your_token_here"

Quick Start

IMPORTANT: Always use the Python script for API calls. It has the correct base URL and authentication built in.

# Search by keyword
python3 {baseDir}/scripts/query.py search "pet food"

# Search with filters
python3 {baseDir}/scripts/query.py search "coffee" --country CN --platform shopify

# Filter only (no keyword)
python3 {baseDir}/scripts/query.py search --country US --platform shopify --min-gmv 1000000

# Search with range filters and sorting
python3 {baseDir}/scripts/query.py search "fashion" --min-instagram 10000 --sort gmvLast12month

# Find stores that have a TikTok page
python3 {baseDir}/scripts/query.py search --platform shopline --exists tiktokUrl

# Find stores with both email and TikTok presence
python3 {baseDir}/scripts/query.py search --country US --exists tiktokUrl,emails

# Get full analytics for a domain
python3 {baseDir}/scripts/query.py domain ooni.com

# Export as JSON
python3 {baseDir}/scripts/query.py domain ooni.com --json

# Get historical GMV and traffic data
python3 {baseDir}/scripts/query.py historical ooni.com

# Get installed apps/plugins
python3 {baseDir}/scripts/query.py apps ooni.com

# Get LinkedIn contacts
python3 {baseDir}/scripts/query.py contacts ooni.com

API Base URL

https://api.eccompass.ai

CRITICAL: All API paths start with /public/api/v1/. The /public prefix is mandatory — without it, you will get an authentication error. Never omit /public from the path.

API Endpoints

1. Search — POST https://api.eccompass.ai/public/api/v1/search

Full URL: https://api.eccompass.ai/public/api/v1/search (POST, Content-Type: application/json)

Authentication: APEX_TOKEN header (NOT Authorization header).

curl -X POST https://api.eccompass.ai/public/api/v1/search \
  -H "APEX_TOKEN: $APEX_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "coffee",
    "filters": { "countryCode4": "CN", "platform": "shopify" },
    "ranges": { "gmvLast12month": { "min": 100000 } },
    "sortField": "gmvLast12month",
    "sortOrder": "desc",
    "page": 1,
    "size": 20
  }'

All body fields are optional.

Exists filter: Use "exists": ["tiktokUrl", "emails"] to require that specific fields are present and not empty. This is the correct way to express "has a TikTok page" or "has contact email". Common exists fields: tiktokUrl, instagramUrl, facebookUrl, youtubeUrl, twitterUrl, linkedinUrl, emails, phones.

Keyword search covers: domain, title, description, tags, categories, platform name, merchant name, technologies, and installed apps. So "klaviyo" in keyword will match stores using the Klaviyo app. You do NOT need to know exact values — just put the search term in the keyword field.

Filters are case-insensitive and support both single values and arrays (OR logic). Any field listed below can be used as a filter, range, or exists condition.

// Single value
{"filters": {"platform": "shopify"}}

// Array = OR logic: matches Europe OR Africa
{"filters": {"region": ["Europe", "Africa"]}}

// Combine keyword + multi-value filter
{"keyword": "energy drink", "filters": {"region": ["Europe", "Africa"]}}

// App/plugin filter
{"filters": {"countryCode4": "US", "installedApps": "klaviyo"}}

Complete Field Reference

Geography (Keyword, for filters): countryCode4, countryCode, countryCode2, countryCode3, city, state, region, subregion, zip, streetAddress, latitude, longitude, companyLocation(Text)

Platform & Store (Keyword, for filters): platform, plan, status, platformDomain, lastPlatform, lastPlan, lastPlatformChanged, lastPlanChanged, created, languageCode, currency, salesChannels

Content (Text, for filters — partial match): description, title, merchantName, categories, tags, tagsV5, metaDescription, metaKeywords, features

Products (Keyword/Text for filters): averageProductPrice(Keyword), avgPriceFormatted(Keyword), categoriesV1(Keyword), tagsFirst(Keyword)

Tech Stack (Text, for filters — partial match): technologies, installedApps, theme, themeVendor, themeSpend, themeVersion(Keyword)

Contact (Text, best with exists): emails, phones, contactPageUrl

Social URLs (for exists — check presence): tiktokUrl, instagramUrl, facebookUrl, youtubeUrl, twitterUrl, linkedinUrl, pinterestUrl, linkedinAccount(Keyword)

Revenue (Long, for ranges — all in USD): gmvLast12month, gmv2023, gmv2024, gmv2025, gmv2026, estimatedMonthlySales, estimatedSalesYearly

Traffic (Long/Integer, for ranges): estimatedVisits, estimatedPageViews, alexaRank, rank, platformRank, rankPercentile(Float), platformRankPercentile(Float)

Products numeric (Integer/Long, for ranges): productCount, avgPriceUsd, maxPrice, minPrice, variantCount, productImages, productsSold, vendorCount

Employees (Integer, for ranges): employeeCount, monthlyAppSpend

Social Followers (Integer, for ranges): instagramFollowers, instagramFollowers30d, instagramFollowers90d, tiktokFollowers, tiktokFollowers30d, tiktokFollowers90d, twitterFollowers, twitterFollowers30d, twitterFollowers90d, youtubeFollowers, youtubeFollowers30d, youtubeFollowers90d, facebookFollowers, facebookFollowers30d, facebookFollowers90d, facebookLikes, pinterestFollowers(Long), pinterestFollowers30d(Long), pinterestFollowers90d(Long)

Growth (Double, for ranges): growth

Tip for the agent:

• Platform names (Shopify, Shopline, WooCommerce, etc.) → prefer keyword over filters.platform (fuzzy match)
• Plugins/apps (Klaviyo, Yotpo, etc.) → use keyword or filters.installedApps / filters.technologies
• Multiple regions/countries (e.g. "Europe or Africa") → array in filters: {"region": ["Europe", "Africa"]}
• "Has TikTok" / "Has Email Adress" → use exists: {"exists": ["tiktokUrl"]} or {"exists": ["emails"]}
• Monthly GMV → use estimatedMonthlySales range directly, or gmvLast12month (annual)

2. Domain Analytics — GET https://api.eccompass.ai/public/api/v1/domain/{domain}

Full URL: https://api.eccompass.ai/public/api/v1/domain/{domain} (GET)

curl -H "APEX_TOKEN: $APEX_TOKEN" https://api.eccompass.ai/public/api/v1/domain/ooni.com

Returns 100+ fields of complete analytics for a single domain.

3. Historical Data — GET https://api.eccompass.ai/public/api/v1/historical/{domain}

curl -H "APEX_TOKEN: $APEX_TOKEN" https://api.eccompass.ai/public/api/v1/historical/ooni.com

Returns monthly GMV, UV, PV, and average price data from 2023 onwards. Use when the user asks for revenue trends, traffic history, or month-over-month performance.

4. Installed Apps — GET https://api.eccompass.ai/public/api/v1/installed-apps/{domain}

curl -H "APEX_TOKEN: $APEX_TOKEN" https://api.eccompass.ai/public/api/v1/installed-apps/ooni.com

Returns the list of apps/plugins installed on a store with details: name, rating, install count, vendor info, pricing plans. Use when the user asks "what apps does X use" or "which plugins are installed".

5. LinkedIn Contacts — GET https://api.eccompass.ai/public/api/v1/contacts/{domain}

curl -H "APEX_TOKEN: $APEX_TOKEN" https://api.eccompass.ai/public/api/v1/contacts/ooni.com

Returns verified LinkedIn contacts for a domain's company: name, position, email, LinkedIn profile URL. Use for lead generation, decision-maker lookup, or outreach.

Requirements

• Python 3.6+
• Network access to api.eccompass.ai
• APEX_TOKEN environment variable (get yours at eccompass.ai)

Documentation

• AI Instructions — How the agent uses this skill
• API Schema — Full response format and field definitions
• Usage Examples — Real-world scenarios with sample output

License

Proprietary — EcCompass AI

Support

For questions, issues, or feature requests, visit https://eccompass.ai.