Skip to main content
POST
/
agent
/
recommend
curl --request POST \
  --url https://api.useadmesh.com/agent/recommend \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "query": "best CRM for startups",
  "format": "auto"
}'
{
  "session_id": "sess_1760022990_w8RkKA",
  "intent": {
    "goal": "The user wants to find and evaluate leading ad networks for potential use.",
    "purchase_intent": "research",
    "intent_type": "product_discovery",
    "categories": [
      "ad_networks",
      "digital_marketing",
      "advertising_platforms"
    ],
    "intent_group": "commercial",
    "layout_type": "citation"
  },
  "response": {
    "summary": "Here are ad_networks tools that match your goal: The user wants to find and evaluate leading ad networks for potential use.",
    "citation_summary": "If you're looking for a top-notch ad network, consider [AdMesh](https://api.useadmesh.com/click/r/b1e5d17f-4f76-4669-800c-163398db0cc5?utm_product=0c9521fb-e60a-443d-84c7-14ce37b1063e&utm_redirect=https%3A%2F%2Fuseadmesh.com%2F&utm_rec=feca26b8-a468-461f-9d14-b8e8951588e1&utm_session=sess_1760022990_w8RkKA&utm_agent=w8RkKArkAad2KEfm3J7kwlvFDzb2&test=true). It's a trusted platform known for excellent earning potential and relevant to your marketing interests.",
    "recommendations": [
      {
        "product_id": "0c9521fb-e60a-443d-84c7-14ce37b1063e",
        "title": "AdMesh",
        "recommendation_description": "Website not provided, assuming as a developer tool for building marketing and design interfaces.",
        "admesh_link": "https://api.useadmesh.com/click/r/b1e5d17f-4f76-4669-800c-163398db0cc5?utm_product=0c9521fb-e60a-443d-84c7-14ce37b1063e&utm_redirect=https%3A%2F%2Fuseadmesh.com%2F&utm_rec=feca26b8-a468-461f-9d14-b8e8951588e1&utm_session=sess_1760022990_w8RkKA&utm_agent=w8RkKArkAad2KEfm3J7kwlvFDzb2&test=true",
        "categories": [
          "Marketing",
          "Development Tools",
          "SaaS"
        ],
        "trust_score": 100,
        "reward_note": "$10.00 per signup (Free Promo Credit - 5 max conversions)",
        "meta": {
          "ad_id": "b1e5d17f-4f76-4669-800c-163398db0cc5",
          "offer_trust_score": 100,
          "brand_trust_score": 100,
          "contextual_relevance_score": 69.19,
          "reason": "This offer matches your category interest and relevant to your query and trusted platform and excellent earning potential.",
          "description": "Website not provided, assuming as a developer tool for building marketing and design interfaces.",
          "keywords": [
            "useadmesh",
            "marketing",
            "design",
            "development",
            "saas",
            "web",
            "tool",
            "interface",
            "building",
            "admesh"
          ],
          "url": "https://useadmesh.com/",
          "redirect_url": "https://useadmesh.com/"
        }
      }
    ],
    "followup_suggestions": [
      {
        "label": "What features does AdMesh offer?",
        "query": "AdMesh key features and benefits"
      },
      {
        "label": "AdMesh pricing plans",
        "query": "AdMesh pricing and plans"
      },
      {
        "label": "Best ad_networks tools like AdMesh",
        "query": "Best ad_networks tools similar to AdMesh"
      }
    ],
    "layout_type": "citation"
  },
  "tokens_used": 500,
  "model_used": "openai/gpt-4o"
}

​
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",
  "format": "auto"
}
Project Management Query: 
{
  "query": "project management tools with time tracking",
  "format": "auto"
}
E-commerce Query: 
{
  "query": "email marketing software for online stores",
  "format": "auto"
}

​
Advanced Features

With Conversation Context: 
{
  "query": "what about integrations with Slack?",
  "format": "auto",
  "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
​
query
string
required

User's search query or question

Required string length: 1 - 500
Example:

"best CRM for startups"

​
format
enum<string>
default:auto

Format type for the response

Available options:
auto,
product,
sidebar,
floating,
expandable,
conversation
Example:

"auto"

​
previous_query
string

Previous query in conversation for context

Maximum length: 500
Example:

"project management tools"

​
previous_summary
string

Summary of previous conversation

Maximum length: 1000
Example:

"We discussed project management solutions"

​
session_id
string

Session identifier for tracking

Maximum length: 100
Example:

"user_session_123"

​
is_fallback_allowed
boolean
default:true

Whether to allow fallback recommendations when no relevant offers are found

Response

Successful response with recommendations

​
session_id
string
required

Unique session identifier for this request

​
intent
object
required

Detected intent information

​
response
object
required

The main response containing recommendations

​
tokens_used
integer
required

Number of tokens used in processing

​
model_used
string
required

AI model used for processing

Example:

"openai/gpt-4o"