Making Your First API Call


Once you’ve trained your engine, you’re ready to make API calls to retrieve search results and/or recommendations from your product catalog. If you haven’t yet trained your engine, please see Training Your First Engine.

Finding your API keys

In order to access your Miso environment programmatically, you will need to find your API keys. There are two varieties of API keys:

  • Publishable API Key - Used to call Miso’s API from your front-end code, such as for streaming customer interactions from the browser
  • Secret API Key - Used to call Miso’s API from your back-end server. Do not share this key publicly. You will use this key for most Miso operations.
  1. Log into Dojo and check the top of left navigation pane to ensure that you’re using the correct environment.

    Figure 1 - Dojo navigation pane

  2. In the left navigation pane, select API Keys & Browser.

  3. Under Development API Keys, you will see the Publishable API Key and the Secret API Key. Click on View secret key to remove the obfuscation.

    Figure 2 - Your unique API Keys are available via Dojo

Sending an API request

Miso supports many endpoints across the Search and Recommendation APIs. For a full list of available endpoints, see the official API doc or the API Browser in Dojo. For this example, we’ll use the search endpoint.

The basic structure of the API request is illustrated in the following example:

POST /v1/search/search
  "q": "jeans",
  "user_id": "user-123"

Figure 3 - The basic structure of the Search API

The customer’s search query is indicated by q and their user id is indicated by the user_id field. Miso uses this information to personalize the customer’s site experience and refine the search and recommendation models.

You can use any language/tool that supports HTTP post requests, such as python, JavaScript, cURL, or Postman. The following is a complete example using JavaScript:

//Sample Request
const apiKey = "<your private api key>"
const url = `${apiKey}`
const payload = [
                "q" : "jeans"
        "user_id": "user_123",
fetch(url, {
    method: "POST",
    headers: {
      "Content-Type": "application/json"
    body: payload
.then(response => response.json()

Figure 4 - Using JavaScript to make an API request to Miso

The response will contain a JSON-formatted list of products:

//Sample Response
            "title":"The 505 Regular Fit Men's Jeans",
            "color":"Rinse - Dark Wash",
            "_search_score": 78.12,
            "_personalization_score": 0.98


Figure 5 - The API response will contain a rank-sorted JSON list of products to display

Try modifying the API parameters to become more familiarized with Miso's capabilities or head over to the Recipes section to learn more about the powerful use cases you can implement with Miso’s Search and Recommendation APIs.

Next: Running Your First A/B Experiment

Icon/Activity Icon/Add Icon/API Icon/Arrow/Down Icon/Arrow/Left Icon/Arrow/Right Icon/Arrow/TopRight Icon/Arrow/Up Icon/Bento Icon/Billing Icon/Bin Icon/Book Icon/Bookmark/Default Icon/Bookmark/Filled Icon/Calendar Icon/Caret/Down Icon/Caret/Up Icon/Chavron/DownIcon/Chavron/LeftIcon/Chavron/RightIcon/Chavron/UpIcon/Checknox/CheckedIcon/Checknox/Unchecked Icon/Checklist Icon/Chip Icon/Clipboard / Copied Icon/Clipboard/Default Icon/Clock/Stopwatch Icon/CMD Icon/Data/Catalog Icon/Data/Engine Icon/Data/Group Icon/Data/Interact Icon/Data/Users Icon/Dive Icon/Docs/Key Icon/Dojo Icon/Email Icon/Env/Development Icon/Env/Playground Icon/Env/Prod Icon/Folder Icon/Fullscreen/Collapse Icon/Fullscreen/Expand Icon/Guides/Multiple Icon/Guides/Single Icon/Hashtag Icon/Heart/Outline Icon/Heart/Solid Icon / Cart z Icon / Click Icon / Clock Icon / Data Icon / Doc Icon / EmptyCart z Icon/Social/Facebook Icon / Genome Incognito Icon / Money Icon/Social/ProductHunt Icon / Search Icon/Social/Twitter Icon / User Icon/Info/Error Icon/Info/Info Icon/Info/Question Icon/Info/Warning Icon/Interact/Download Icon/Interact/Edit Icon/Interact/External v2 Icon/Interact/External Icon/Interact/Filter Icon/Interact/Logout Icon/Interact/Options Icon/Interact/Re-order Icon/Interact/Reload Icon/Interact/Remove Icon/Interact/Replace Icon/Interact/Search Icon/Interact/Shuffle Icon/Interact/Undo Icon/Interact/Upload Icon/Interact/Video Icon/Invoice Icon/Loading Icon/Loading Icon/Lock/Locked Icon/Lock/Unlocked Icon/Lock Icon/Mapping Menu Icon/Notification Icon/Overview Icon/Person/Team Icon/Person/User Icon/Plan/Enterprise Icon/Plan/Growth Icon/Plan/Startup Icon/Plan/Trial Icon/Recipe Icon/Rocket Icon/Settings/App Icon/Settings/User Icon/Settings Icon/Shrine Icon/Sidebar/Close Icon/Sidebar/Open Icon/Slideout Icon/Sort/Ascending Icon/Sort/Default Icon/Sort/Descending Icon/Star/Filled Icon/Star/Outlined Stopwatch Icon/Support Icon/Tag Icon/Interact/Thumb/Dislike Icon/Interact/Thumb/Like Icon/Tick Icon/Trend/New Icon/Trend/Trending Icon/Tutorial Icon/Lock/Unlocked Icon/View/Grid Icon/View/List Icon/Watchlist/Add