Skip to main content
Once you have a valid session, call the /agent/recommend endpoint.
  • TypeScript/JavaScript
  • React
  • Android (Kotlin)
  • Flutter (Dart)
  • Swift/iOS
  • React Native
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

ParameterTypeRequiredDescription
querystringYesUser’s search or chat query
session_idstringYesSession ID from /agent/session/new
formatstringNoLayout format: auto, card, inline
Next → Weave Inline Recommendations