API
Tool Agent API
Call Ecomwith tools from your agent, automation script, or internal workflow with an API key. This guide currently covers GTIN, QR Code, UTM Builder, and Break-even ROAS APIs.
Authentication
Create an API key from settings. The full secret is shown once, so copy it into your agent or secret manager. Later views only show a masked key.
Authorization: Bearer ecw_live_...
X-API-Key: ecw_live_...Quota And Rate Limits
API usage is tracked separately. Responses include quota and rate-limit headers so your agent can decide whether to continue.
X-Quota-Limit: 1000
X-Quota-Remaining: 997
X-RateLimit-Limit: 30Safe Retries
If a request times out or your agent retries automatically, send the same Idempotency-Key. The same request key and body reuse the result without duplicate generation or quota usage.
Idempotency-Key: order-sync-2026-06-14-001Endpoints
GTIN API
Generate GTIN-14 numbers in batches. Quota is counted by generated numbers.
QR Code API
Generate SVG or PNG data URL QR codes from links or text. Quota is counted by request.
UTM Builder API
Apply one UTM parameter set to one or many landing page URLs. Quota is counted by successfully built links.
Break-even ROAS API
Calculate break-even ROAS, target-profit ROAS, and CPA guardrails from price, costs, fees, and refund reserve.
OpenAPI JSON
/api/v1/openapi.json