Public API · 1M+ Shopify stores

Live Ecommerce API
for AI Agents

Traffic, revenue estimates, price cuts, and ad performance for over a million Shopify stores — one REST call away. Ask ChatGPT, Claude, or your own script, and get answers backed by real store data instead of guesses.

Key included on Starter and Pro · docs are free

Live example
Run in docs →
GEThttps://api.ecomscout.com/v1/stores?q=gruntstyle&limit=5

Type a name. Get the store, traffic, and revenue band back in one call.

gruntstyle.com

Military apparel · 927 SKUs

USS

Monthly visits

1.1M

Revenue / mo

$370–802k

1M+
Shopify stores
50M+
Products tracked
Daily
Snapshots
< 5 min
First call

What it's for

Research that used to take a day now takes a prompt

The same intelligence behind the EcomScout app, exposed as clean JSON. Three ways people put it to work:

Analysts · founders · VCs

Due diligence on any brand in seconds

Type a brand name, get back its traffic, revenue band, catalog size, and app stack. Size a whole vertical by country, or screen for the fastest-growing stores this week — without opening a dashboard.

  • GET /v1/stores?q=…brand → store card with visits and revenue band
  • GET /v1/stores?groupBy=countrymarket size rolled up like the app
  • GET /v1/analytics/moverswho jumped or slipped this week
Agencies · store operators

Watch competitors while you sleep

Point a Signal at a rival and get their estimated sales, restocks, and which ads actually moved revenue. Poll price drops across the whole catalog weekly — a screen your script or agent runs for you.

  • POST /v1/signalsstart tracking a rival’s sales and inventory
  • GET /v1/signals/{id}/ads/overviewwhich creatives lifted which SKUs
  • GET /v1/products/changesevery markdown ≥10% since your last check
AI builders · agents

One link teaches your agent everything

Paste one brief into Claude, ChatGPT, or Cursor and it knows every endpoint, filter, and rule. Docs, OpenAPI spec, and examples are open with no key — your agent explores first, you pay only when it pulls data.

  • api.ecomscout.com/v1/llms.txtthe agent brief — paste it into any chat
  • GET /v1/openapi.jsonOpenAPI 3.1 for Postman or codegen
  • GET /v1/examplesready-made JSON playbooks per use case

How it works

From signup to first answer in five minutes

  1. 1

    Create an account

    Sign up free. Docs, the playground, and the agent brief are open right away — no key needed to explore.

  2. 2

    Pick Starter or Pro

    A paid plan mints your API key on the Integrations page. The key shares the same daily quota as your app account.

  3. 3

    Make your first call

    One header, one URL. Search a brand, then fetch the domain the API returned.

Your first call
curl -H "Authorization: Bearer esc_YOUR_KEY" \
  "https://api.ecomscout.com/v1/stores?q=gruntstyle&limit=5"

Returns the store card: domain, grade, monthly visits, revenue band, catalog size. Then fetch /v1/stores/gruntstyle.com for the full picture.

Using an AI agent instead?

Skip the docs. Paste api.ecomscout.com/v1/llms.txt into your chat and the agent learns the whole API by itself.

Coverage

Seven endpoint groups, one key

Full reference in docs →

Common questions

Do I need a paid plan to get an API key?

Yes. Free accounts can explore the docs, playground, and agent brief, but only Starter ($49/mo) or Pro ($149/mo) can mint a key on the Integrations page. The key shares the same daily quota as your app account, so one plan covers both.

How do I authenticate?

Send Authorization: Bearer esc_… or X-Api-Key: esc_… on every data call. Keep the key out of URLs and shared chats. If you hit a 429, wait the Retry-After seconds and try again.

Where does the data come from — is revenue real GMV?

Revenue is a modeled low–high band, not merchant-reported GMV. Traffic comes from third-party estimates. Signals sales are derived from inventory snapshots on stores you track. Everything is labeled so you can quote it honestly.

Can my AI agent use this on its own?

Yes — that is the point. Paste api.ecomscout.com/v1/llms.txt into Claude, ChatGPT, or Cursor. The brief teaches it every endpoint and rule. You supply the key privately; the agent does the calls.

What if a store is missing?

POST /v1/scrapes with the domain. We queue a scrape, and the store shows up under GET /v1/stores/{domain} in about two minutes — or we call your webhook when it is done.

Give your agent real store data

Explore the docs free. When you're ready, Starter or Pro mints your key and your first call is minutes away.