Skip to main content
Get a working widget on a local HTML page using sandbox credentials and synthetic demo reviews.

1. Create sandbox API credentials

In the dashboard: Integrations → API Clients → Create client Save the response immediately — the secret (sk_test_*) is shown once. Copy the publishable key (pk_test_*) for the browser widget.

2. Register a widget (optional)

Integrations → Widgets → Create
  • Environment: SANDBOX
  • Min stars: 4 (top-rated only)
  • Link to the sandbox API client you created
Note the widget ID if you want a single-call resolve endpoint.

3. Embed on your site

4. Verify

Open your page. You should see synthetic sandbox testimonials (not production data). Each card links to a demo EthioReview review URL.
Use GET /api/v1/widgets/businesses/{orgId}/reviews with header X-Widget-Key: pk_test_... to debug outside the browser.

5. Go to production

  1. Create a PRODUCTION API client with your live domain in allowedOrigins
  2. Create a production widget linked to that client
  3. Swap pk_test_*pk_live_* in your embed snippet
  4. Never put sk_live_* in frontend code — use it only on your server
Credentials deep dive →