Get Recommendations

Fetch product or offer recommendations for a given query

Once you have a valid session, call the /agent/recommend endpoint.

TypeScript/JavaScript

export async function getAdmeshRecommendations(query: string) {
  const ADMESH_BASE = "https://api.useadmesh.com";
  const sessionId =
    localStorage.getItem("admesh_session_id") || (await createAdmeshSession());

  const res = await fetch(`${ADMESH_BASE}/agent/recommend`, {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.REACT_APP_ADMESH_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ query, session_id: sessionId, format: "auto" }),
  });

  if (res.status === 401) {
    const newSession = await createAdmeshSession();
    return getAdmeshRecommendations(query);
  }

  return res.json();
}

Example Response

{
  "session_id": "admesh_sess_1760022990_w8RkKA",
  "placements": [
    {
      "id": "plc_01",
      "title": "Notion for Teams",
      "reason": "Recommended for collaboration",
      "ad_id": "ad_7a2b",
      "click_url": "https://api.useadmesh.com/click/r/ad_7a2b?...",
      "exposure_url": "https://api.useadmesh.com/expose/ad_7a2b?..."
    }
  ]
}

Parameters

Parameter	Type	Required	Description
query	string	Yes	User’s search or chat query
session_id	string	Yes	Session ID from /agent/session/new
format	string	No	Layout format: auto, card, inline

---

Next → Weave Inline Recommendations