Embeddable Public APIs

Get started with Embeddable's customer-facing APIs (listed here).

Bruno is a fully offline, git-native, open-source API Client (like Postman, but better).

Getting started

• Clone (or download) this repo locally
  • e.g. git clone https://github.com/embeddable-hq/embeddable-public-apis.git
• Install Bruno (here)
  • e.g. brew install bruno
• Open Bruno (e.g. on Mac Bruno appears in the Applications folder)
• Click 'Open collection' and choose the bruno/Embeddable-API folder in your downloaded repo.

• Select "Embeddable-API" from the left-hand menu.
• Choose "Safe mode" when prompted.

Configuring Bruno

• In the top-right corner of Bruno, choose 'No environment'->'embeddable.com'.
• Now, in the same menu, click 'Configure'.
• Enter your workspace region (eu or us) and enter your Embeddable api-key (from here).
• Click Save.

Your first request

• Navigate to Embeddables -> List embeddables.
• Click the right arrow (->) on the right side of the screen to execute the request.
• You should see the response appear in the right panel.

• For other requests you may need to update the Body or Vars for them to run correctly.

Secrets

Secret variables such as passwords and tokens are stored in the 'embeddable.com' environment.

• Click the environment dropdown in the top-right corner of Bruno
• Make sure 'embeddable.com' is selected
• Click 'Configure'
• After you've set your secret variable, make sure to save your changes

Troubleshooting

• Error: getaddrinfo ENOTFOUND {{host}}
  • Solution: make sure you've picked embeddable.com as your environment (top right corner)

---

Embeddable is a developer toolkit for building fast, interactive, customer-facing analytics directly into your product. Fully customize analytics dashboards using React.js, and seamlessly integrate them anywhere with Web Components.

Discover more about Embeddable by reading our Docs, Customer Stories, and Blog.