OpenAPI 3.1.0 · Clay / n8n / Make / AI Agents

StoreTechScan Developer API & OpenAPI Specification

Enrich 1 to 100 domains per synchronous call via /api/v1/inspect using your Bearer API Key. Failed or unreachable domains (DNS error, >8s timeout, TLS error, 5xx, 429 rate-limit) are refunded automatically in the same request.

Updated and reviewed:

Quick Start (cURL)

cURL
curl -X POST https://storetechscan.com/api/v1/inspect \
  -H "Authorization: Bearer zsk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domains": ["gymshark.com", "allbirds.com"]}'

Single-Domain GET (Clay / Make Friendly)

cURL
curl -H "Authorization: Bearer zsk_live_YOUR_API_KEY" \
  "https://storetechscan.com/api/v1/inspect?domain=gymshark.com"

Choose a workflow

For interactive review, use the web workspace and CSV export. For automation, use the paid synchronous API with up to 100 unique domains per request. More than 100 is rejected before any credits are reserved.

Errors and retries

  • 401: check the Bearer key. 402: check the available balance. 400: correct the input or split the batch.
  • A new inspect request can charge again. Do not blindly retry an ambiguous timeout; retain responses and check the credit ledger.
  • The web preview allowance does not apply to synchronous API requests. Non-billable failures are refunded within settlement.
  • Include an explicit User-Agent header (for example StoreTechScanClient/1.0) when calling from Python urllib or custom scripts so edge bot rules allow automated requests cleanly.

A running server accepts up to 4 synchronous inspections at once by default. Excess requests receive 429 with Retry-After before credits are reserved. Queue work in your client rather than sending an unlimited burst.

HTTP
GET /api/v1/credits
Authorization: Bearer zsk_live_YOUR_KEY

Key Response Fields

FieldTypeDescription
billablebooleanfalse on DNS_ERROR, TIMEOUT, TLS_ERROR, HTTP_5XX, HTTP_429, WAF_CHALLENGE, SSRF_BLOCKED ($0 deducted)
tech_stackstring[]Detected frameworks, e-commerce platforms, marketing/support apps, and pixels
shopify_products_count_samplenumber | nullCount from /products.json?limit=250 (0 = empty public catalog; null = unavailable; smaller samples may be used)
shopify_price_min / median / maxnumber | nullVariant price distribution in shopify_currency
icp_vertical / business_model / icp_one_linerstringHomepage vertical classification (B2C / DTC, B2B, SaaS, Agency / Service)
icp_fit_score / is_real_merchant / has_b2b_wholesalenumber | booleanCalibrated prospect score (1.0–5.0), active merchant verification, and wholesale/B2B signal (calibrated_ai on paid calls)
primary_email / generic_emailsstring[]Only functional role emails (info@, support@, sales@, hello@, contact@, partnerships@, team@, press@)

Account & Credits (No Subscription)

First credit pack adds +25 bonus credits (Starter $9 = 525) · Secure checkout via Waffo · Credits never expire · Failed domains cost $0 · 14-day unused pack refund policy

Buy or Top Up Credit Packs (One-Time)

Starter
$9
500 reachable domains · $0.018 / domain

One-time 500 reachable domain credits · Full CSV export · Never expires

Agency
$49
10,000 reachable domains · $0.0049 / domain

One-time 10,000 reachable domain credits · Full CSV + OpenAPI Key · Never expires