Listing AI agent products

Before you begin the step-by-step instructions, you can also watch this short walkthrough video that demonstrates how to create an AI agent product listing on AWS Marketplace.

Prerequisites

Before beginning, ensure that you have the following:

• A clear understanding of your AI agent capabilities and target use cases.

• Technical documentation for integration and deployment.

• Pricing strategy aligned with your business model.

Listing API-based AI agent products

⚠ Important Note

While Clazar can assist with the creation and setup of an AI Agent product listing on AWS Marketplace, the fulfillment URL and SaaS integration must be built and hosted by the ISV.

Currently, Clazar does not support creating API-based AI agent listings directly via the platform. However, we can guide the ISV through building and launching the listing directly on AWS.

Once the listing is live, it will be managed by the ISV via the AWS Marketplace Management Portal.

Start the listing wizard

1. Sign in to the AWS Marketplace Management Portal.

2. On the Products menu, choose SaaS.

3. For Create SaaS or AI agents & tools product, choose AI agents & tools product.

4. (Optional) Add tags to label your product.

5. Enter a product title.

6. Choose 'Generate product ID and code,' and then select 'Continue to wizard.'

Step 1: Provide product information

Enter the following:

• Product title

• SKU (optional)

• Amazon product logo S3 URL

• Short description

• Long description

• Product video URL (optional)

• Highlights (1-3)

1. Enter support details and add optional learning resources by choosing Add resource.

2. In the Product categories menu, choose 1-3 categories. We recommend that you choose at least one category from the AI Agents & Tools business categories.

3. Enter keywords to improve search discoverability.

4. (Optional) Add video and image assets according to the guidelines.

5. Choose Next.

Step 2: Configure fulfillment options

1. Choose a fulfillment method.

   Note

   You can't change the fulfillment method after you publish the product.

2. Enter the fulfillment URL.

   Note

   The fulfillment URL is your landing page where AWS Marketplace will redirect buyers to after they subscribe to your product (also known as your SaaS landing page or SaaS fulfillment URL).

3. Enter the endpoint URL.

4. Choose an authorization method:

   • API Keys – Customers authenticate using API keys that you provide.

   • OAuth – Customers authenticate using OAuth 2.0 authorization flow.

   If you choose OAuth, provide clear usage instructions for customers, including:

   • OAuth authorization URL and token endpoint

   • Required scopes and permissions

   • Step-by-step authentication flow instructions

   • Example API calls with proper authentication headers

   • Troubleshooting common authentication issues

5. (Optional) Add integration protocols.

   Specify any integration protocols your AI agent or tool supports, such as MCP or other standardized communication protocols. This helps customers understand how to integrate your solution into their existing workflows.

6. Choose your AI agent or tool type.

   Note

   If you choose Free product, pricing and refund policy settings don't apply.

7. Provide detailed usage instructions.

Usage instructions example

When listing your AI agent or tool on AWS Marketplace, provide clear usage instructions to help customers integrate and use your solution.

To get started follow the instructions below:

**Authentication**

All API requests require this HTTP header:

Authorization: Bearer `YOUR_API_KEY`

Replace `YOUR_API_KEY` with your actual key.

🔍 **Search Endpoint**

**Endpoint:**  `GET /web/search`

Performs a web search.

**Query Parameters:**

| Param | Type | Description |
|------------|--------|-------------------------------------|
|  `q`  | string | Your search query (required) |
|  `count`  | int | Number of results (default: 10) |
|  `offset`  | int | Offset for pagination |
|  `country`  | string | Country code (e.g. `us`, `de`) |
|  `safesearch`  | string |  `off`, `moderate`, or `strict`  |

**Example Request:**
```bash
curl -X GET "https://api.search.demo.com/res/v1/web/search?q=searchtool" \
-H "Authorization: Bearer YOUR_API_KEY"
```
**Response Schema:**  
```  
{
	"results": [{  
			"title": "string",  
			"url": "string",
			"description": "string"  
	}],
	"query" :"string",
	"total" :"number"
}  
```

**Example Response:**
```
{
	"results": [
	  {
		"title": "DemoProductAPI",
		"url": "https://demo.com",
		"description": "Demo Product API is a search tool for..."
	  }
	],
	"query": "searchtool",
	"total": 1
}
```
🧠 **Additional Search Types**
DemoProduct also supports:
- `GET /news/search – News articles`
- `GET /images/search – Image results`
- `GET /videos/search – Video results`

These endpoints follow the same format as /web/search.

📥 **Summarize Endpoint**

**Endpoint:**  `POST /summarize`

Summarizes a webpage 

**Request Headers:**  
Content Type: application/json

**Request Body:**  
```  
{
	"input": "string" // URL or plain text
}    
```
**Example Request:** 
```
{
	"input": "https://example.com/article"
} 
```

**Response Schema**
```
	{
			"summary": "string"  
	}    
```

**Example Response**
```	
	{
		 "summary": "This article explains our commitment to user privacy."
	}   
```
📛 **Error Codes**

| Status | Meaning |
| ------ | ------------------------------ |
|  `401`  | Unauthorized (check your key) |
|  `429`  | Too many requests (rate limit) |
|  `500`  | Server error |

All error responses follow this structure:
```
{
	"error": {
	"code": 401,
	"message": "Unauthorized"
	}
}
```
⏱️ **Rate Limits**
- 60 requests per minute per API key.  
- Exceeding returns HTTP 429 Too Many Requests.  
- Use retry and exponential backoff to handle limits.  

📘 **Learn More**
📄 API Docs: https://api.search.demoproduct.com

Step 3: Configure product pricing

1. Choose a pricing model.

2. Choose Next.

Step 4: Review prices

1. Set and review product pricing.

2. Choose Next.

Step 5: Specify refund policy

1. Enter a refund policy.

2. Choose Next.

Step 6: Configure EULA

1. Choose Standard Contract for AWS Marketplace or Custom EULA.

   Note

   If you choose Custom EULA, enter a URL for the end-user license agreement.

2. Choose Next.

Step 7: Configure offer availability

1. Choose your offer availability by country.

2. Choose Next.

(Optional) Step 8: Allowlisted accounts

1. Enter the allowlisted AWS accounts.

2. Separate allowlisted accounts with commas.

3. Choose Submit.