EcomScout

EcomScout Analytics API

Market rollups for briefing / screening

GitHub OpenAPI

Operations 7

GET /v1/analytics/overview Coverage snapshot + top verticals/countries #
GET /v1/analytics/verticals Market stats by vertical #
GET /v1/analytics/countries Market stats by country (TAM snapshot) #
GET /v1/analytics/movers Stores whose visits or modeled revenue moved across the window (one row per… #
GET /v1/analytics/trends Month-over-month visit trends by vertical, country, industry, category or size… #
GET /v1/analytics/trends/stores Stores behind a trend window: visits in from and to month, delta and growth… #
GET /v1/analytics/trends/coverage Stores with a traffic reading per month, total and above minVisits, optionally… #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/ecomscout-com/openapi/ecomscout-com-analytics-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/ecomscout-com/json-schema/ecomscout-com-audience-definition-schema.json
📊
JSONSchema
https://artifacts.apis.io/ecomscout-com/json-schema/ecomscout-com-store-inventory-probe-schema.json
📊
JSONSchema
https://artifacts.apis.io/ecomscout-com/json-schema/ecomscout-com-competitor-store-schema.json
📊
JSONSchema
https://artifacts.apis.io/ecomscout-com/json-schema/ecomscout-com-product-inventory-probe-schema.json

Other Resources

🔗
APIsJSON
https://artifacts.apis.io/ecomscout-com/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/ecomscout-com:ecomscout-com-analytics-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

ecomscout-com-analytics-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: EcomScout Public Analytics API
  version: 0.7.0
  description: Unified ecommerce intelligence API for coding agents, app builders, and VC/PE analysts. Stores, products, apps, analytics, changes, signals, scrapes — one JSON object per resource. Read /v1/llms.txt then /v1/examples before calling data endpoints. Only 2xx responses burn daily quota and plan buckets; 4xx do not. Store contacts (company, emails, phones) on GET /v1/stores/{domain} and GET /v1/stores/{domain}/contacts.
servers:
- url: https://api.ecomscout.com
security:
- apiKey: []
- bearer: []
tags:
- name: Analytics
  description: Market rollups for briefing / screening
paths:
  /v1/analytics/overview:
    get:
      tags:
      - Analytics
      summary: Coverage snapshot + top verticals/countries
      operationId: marketOverview
  /v1/analytics/verticals:
    get:
      tags:
      - Analytics
      summary: Market stats by vertical
      operationId: verticalStats
      parameters:
      - name: countryCode
        in: query
        schema:
          type: string
          minLength: 2
          maxLength: 2
      - name: limit
        in: query
        schema:
          type: integer
          default: 50
  /v1/analytics/countries:
    get:
      tags:
      - Analytics
      summary: Market stats by country (TAM snapshot)
      description: Unfiltered geo rollup, optional one vertical. For a filtered cohort (minVisits, appSlug, isDropshipper, revenue/rating) use GET /v1/stores?groupBy=country with the same filters as store search.
      operationId: countryStats
      parameters:
      - name: vertical
        in: query
        schema:
          type: string
      - name: limit
        in: query
        schema:
          type: integer
          default: 50
  /v1/analytics/movers:
    get:
      tags:
      - Analytics
      summary: Stores whose visits or modeled revenue moved across the window (one row per…
      operationId: storeMovers
      parameters:
      - name: metric
        in: query
        schema:
          type: string
          enum:
          - visits
          - revenue
          - any
      - name: direction
        in: query
        schema:
          type: string
          enum:
          - up
          - down
          - any
      - name: vertical
        in: query
        schema:
          type: string
      - name: countryCode
        in: query
        schema:
          type: string
      - name: since
        in: query
        schema:
          type: string
        description: Window start, default 30 days back. History starts 2026-06.
      - name: minPct
        in: query
        schema:
          type: number
          default: 5
      - name: minVisits
        in: query
        schema:
          type: number
          default: 0
        description: Minimum metric value at the window start
      - name: sort
        in: query
        schema:
          type: string
          enum:
          - pct
          - delta
          - new
          default: pct
      - name: limit
        in: query
        schema:
          type: integer
          default: 20
          maximum: 100
      - name: offset
        in: query
        schema:
          type: integer
          default: 0
  /v1/analytics/trends:
    get:
      tags:
      - Analytics
      summary: Month-over-month visit trends by vertical, country, industry, category or size…
      operationId: trafficTrends
      parameters:
      - name: groupBy
        in: query
        schema:
          type: string
          enum:
          - vertical
          - country
          - industry
          - category
          - sizeTier
          - month
          default: vertical
      - name: from
        in: query
        required: true
        schema:
          type: string
          example: 2026-01
        description: YYYY-MM. Check /v1/analytics/trends/coverage for usable months.
      - name: to
        in: query
        required: true
        schema:
          type: string
          example: 2026-06
        description: YYYY-MM, after from
      - name: minVisits
        in: query
        schema:
          type: number
          default: 10000
        description: Visits floor; see floorOn
      - name: floorOn
        in: query
        schema:
          type: string
          enum:
          - from
          - to
          - both
          - avg
          default: avg
        description: Which month(s) the floor applies to. from alone shows regression to the mean
      - name: cohort
        in: query
        schema:
          type: string
          enum:
          - edges
          - all
          default: edges
        description: 'edges: reading in from and to. all: reading in every month of the window'
      - name: vertical
        in: query
        schema:
          type: string
      - name: excludeVerticals
        in: query
        schema:
          type: string
      - name: countryCode
        in: query
        schema:
          type: string
      - name: country
        in: query
        schema:
          type: string
        description: Names, ISO codes or regions, comma list
      - name: excludeCountries
        in: query
        schema:
          type: string
      - name: industry
        in: query
        schema:
          type: string
      - name: category
        in: query
        schema:
          type: string
      - name: isDropshipper
        in: query
        schema:
          type: boolean
      - name: appSlug
        in: query
        schema:
          type: string
        description: Slug as in store.apps[].slug, e.g. klaviyo
      - name: includeApps
        in: query
        schema:
          type: string
        description: Comma list, any match (appsMatch=all for every)
      - name: requireApps
        in: query
        schema:
          type: string
      - name: excludeApps
        in: query
        schema:
          type: string
      - name: appsMatch
        in: query
        schema:
          type: string
          enum:
          - any
          - all
      - name: includeProducts
        in: query
        schema:
          type: string
      - name: excludeProducts
        in: query
        schema:
          type: string
      - name: minStores
        in: query
        schema:
          type: integer
          default: 20
        description: Hide groups with fewer cohort stores
      - name: sort
        in: query
        schema:
          type: string
          enum:
          - stores
          - growth
          - visits
          default: stores
      - name: limit
        in: query
        schema:
          type: integer
          default: 50
          maximum: 200
  /v1/analytics/trends/stores:
    get:
      tags:
      - Analytics
      summary: 'Stores behind a trend window: visits in from and to month, delta and growth…'
      operationId: trafficTrendStores
      parameters:
      - name: from
        in: query
        required: true
        schema:
          type: string
          example: 2026-01
      - name: to
        in: query
        required: true
        schema:
          type: string
          example: 2026-06
      - name: minVisits
        in: query
        schema:
          type: number
          default: 10000
        description: Visits floor; see floorOn
      - name: floorOn
        in: query
        schema:
          type: string
          enum:
          - from
          - to
          - both
          - avg
          default: avg
        description: Which month(s) the floor applies to. from alone shows regression to the mean
      - name: cohort
        in: query
        schema:
          type: string
          enum:
          - edges
          - all
          default: edges
        description: 'edges: reading in from and to. all: reading in every month of the window'
      - name: vertical
        in: query
        schema:
          type: string
      - name: excludeVerticals
        in: query
        schema:
          type: string
      - name: countryCode
        in: query
        schema:
          type: string
      - name: country
        in: query
        schema:
          type: string
        description: Names, ISO codes or regions, comma list
      - name: excludeCountries
        in: query
        schema:
          type: string
      - name: industry
        in: query
        schema:
          type: string
      - name: category
        in: query
        schema:
          type: string
      - name: isDropshipper
        in: query
        schema:
          type: boolean
      - name: appSlug
        in: query
        schema:
          type: string
        description: Slug as in store.apps[].slug, e.g. klaviyo
      - name: includeApps
        in: query
        schema:
          type: string
        description: Comma list, any match (appsMatch=all for every)
      - name: requireApps
        in: query
        schema:
          type: string
      - name: excludeApps
        in: query
        schema:
          type: string
      - name: appsMatch
        in: query
        schema:
          type: string
          enum:
          - any
          - all
      - name: includeProducts
        in: query
        schema:
          type: string
      - name: excludeProducts
        in: query
        schema:
          type: string
      - name: direction
        in: query
        schema:
          type: string
          enum:
          - up
          - down
          - any
          default: any
      - name: sort
        in: query
        schema:
          type: string
          enum:
          - pct
          - delta
          - visits
          default: pct
      - name: limit
        in: query
        schema:
          type: integer
          default: 20
          maximum: 100
      - name: offset
        in: query
        schema:
          type: integer
          default: 0
  /v1/analytics/trends/coverage:
    get:
      tags:
      - Analytics
      summary: Stores with a traffic reading per month, total and above minVisits, optionally…
      operationId: trafficTrendCoverage
      parameters:
      - name: minVisits
        in: query
        schema:
          type: number
          default: 10000
      - name: vertical
        in: query
        schema:
          type: string
      - name: countryCode
        in: query
        schema:
          type: string
      - name: industry
        in: query
        schema:
          type: string
      - name: category
        in: query
        schema:
          type: string
      - name: isDropshipper
        in: query
        schema:
          type: boolean
      - name: appSlug
        in: query
        schema:
          type: string
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-Api-Key
    bearer:
      type: http
      scheme: bearer