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 10M+ 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

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.

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.

Quickest Way — Just Tell OpenClaw

Paste this to your OpenClaw agent and it will install the skill and configure the token for you:

Install this skill: https://clawhub.ai/roger52027/ecommerce-website-data
My APEXTOKEN is: yourtoken_here

Get your free token at eccompass.ai → Dashboard → API Access → Create Token.

Manual Install via OpenClaw CLI

CODEBLOCK0

Then configure the token (choose one):

Option A — OpenClaw config (persistent):

Add to ~/.openclaw/openclaw.json:

CODEBLOCK1

Option B — Shell environment variable:

CODEBLOCK2

Quick Start

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

CODEBLOCK3

API Base URL

CODEBLOCK4

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).

CODEBLOCK5

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.

CODEBLOCK6

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, INLINECODE41

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

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, INLINECODE63

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, INLINECODE78

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, INLINECODE93

Employees (Integer, for ranges):
employeeCount, INLINECODE95

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):
INLINECODE115

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 / INLINECODE120
• Multiple regions/countries (e.g. "Europe or Africa") → array in filters: INLINECODE121
• "Has TikTok" / "Has Email Address" → use exists: {"exists": ["tiktokUrl"]} or INLINECODE124
• 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)

CODEBLOCK7

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

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

CODEBLOCK8

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}

CODEBLOCK9

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}

CODEBLOCK10

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 INLINECODE132
• INLINECODE133 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.