POST
/
agent
/
recommendations
curl --request POST \
  --url https://api.useadmesh.com/agent/recommendations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "query": "best CRM for startups",
  "agent_id": "your_agent_id"
}'
{
  "recommendations": [
    {
      "title": "HubSpot CRM",
      "reason": "Perfect for startups with its free tier and comprehensive features including contact management, deal tracking, and email integration.",
      "admesh_link": "https://useadmesh.com/r/hubspot-crm-abc123",
      "ad_id": "ad_123456789",
      "product_id": "hubspot_crm",
      "pricing": "Free tier available, paid plans from $45/month",
      "features": [
        "Contact management",
        "Deal pipeline tracking",
        "Email integration",
        "Reporting dashboard"
      ],
      "description": "A comprehensive CRM platform designed for growing businesses",
      "has_free_tier": true,
      "trial_days": 14,
      "intent_match_score": 0.92,
      "offer_trust_score": 0.88,
      "brand_trust_score": 0.95
    }
  ],
  "query_processed": "best CRM for startups",
  "total_recommendations": 1,
  "processing_time_ms": 245
}

​
API Playground

Test the AdMesh Recommendations API interactively with real requests and responses.

​
Quick Test

Use the interactive playground above to test the recommendations endpoint with your API key.

​
Example Requests

Try these example queries to see how AdMesh works: Basic CRM Query: 
{
  "query": "best CRM for startups",
  "agent_id": "your_agent_id"
}
Project Management Query: 
{
  "query": "project management tools with time tracking",
  "agent_id": "your_agent_id"
}
E-commerce Query: 
{
  "query": "email marketing software for online stores",
  "agent_id": "your_agent_id"
}

​
Advanced Features

With Conversation Context: 
{
  "query": "what about integrations with Slack?",
  "agent_id": "your_agent_id",
  "previous_query": "project management tools",
  "previous_summary": "We discussed project management solutions with time tracking features",
  "session_id": "user_session_123"
}

​
Authentication

To use the playground:
  1. Get your API key from useadmesh.com
  2. Click the “Authorize” button above
  3. Enter your API key in the format: admesh_prod_abc123xyz789
  4. Test the endpoint with your queries

​
Response Format

Each recommendation includes:
  • title - Product/service name
  • reason - Why it’s recommended for your query
  • admesh_link - Tracking URL (use this for clicks)
  • pricing - Cost information
  • features - Key features list
  • trust scores - Quality and reliability metrics

​
Rate Limits

  • Free Tier: 1,000 requests per month
  • Pro Tier: 10,000 requests per month
  • Enterprise: Custom limits

​
Need Help?

Authorizations

​
Authorization
string
header
required

Enter your AdMesh API key (format: admesh_prod_abc123xyz789)

Body

application/json

Response

200
application/json

Successful response with recommendations

The response is of type object.