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.
Quick Start (cURL)
curl -X POST https://storetechscan.ytriple.dev/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 -H "Authorization: Bearer zsk_live_YOUR_API_KEY" \ "https://storetechscan.ytriple.dev/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.
GET /api/v1/credits
Authorization: Bearer zsk_live_YOUR_KEY
Key Response Fields
| Field | Type | Description |
|---|---|---|
| billable | boolean | false on DNS_ERROR, TIMEOUT, TLS_ERROR, HTTP_5XX, HTTP_429, WAF_CHALLENGE, SSRF_BLOCKED ($0 deducted) |
| tech_stack | string[] | Detected frameworks, e-commerce platforms, marketing/support apps, and pixels |
| shopify_products_count_sample | number | null | Count from /products.json?limit=250 (0 = empty public catalog; null = unavailable; smaller samples may be used) |
| shopify_price_min / median / max | number | null | Variant price distribution in shopify_currency |
| icp_vertical / business_model / icp_one_liner | string | Homepage vertical classification (B2C / DTC, B2B, SaaS, Agency / Service) |
| icp_fit_score / is_real_merchant / has_b2b_wholesale | number | boolean | Calibrated prospect score (1.0–5.0), active merchant verification, and wholesale/B2B signal (calibrated_ai on paid calls) |
| primary_email / generic_emails | string[] | Only functional role emails (info@, support@, sales@, hello@, contact@, partnerships@, team@, press@) |