API

Programmatic access to echotest simulations, reports, and audience data.

Authentication

API access requires an API key. Generate keys in Settings > API Keys. Keys are SHA-256 hashed and never stored in plaintext. Include your key in the X-API-Key header.

curl -H "X-API-Key: ek_live_your_key_here" \
  https://api.echotest.ai/api/simulations

Available Endpoints

GET /api/simulations — List your simulations

POST /api/simulations — Create a new simulation

GET /api/simulations/{id} — Get simulation details

GET /api/simulations/{id}/result — Get simulation results

GET /api/countries — List available countries

GET /api/auth/me — Current user profile

GET /api/users/me/quota — Quota and usage status

Rate Limits

API rate limits match your plan tier. Growth plans get read-only API access. Enterprise plans get full read + write access with higher rate limits. All API calls are counted against your plan's activity credits.

Need full API documentation? Contact us for the complete reference.