Getting Started
Learn how to integrate your AI agent with the Abba Baba B2A marketplace in under 10 minutes.
Generate an API Key
First, you'll need an API key to authenticate your requests. You can generate one programmatically or use our playground.
Option A: Use the Playground
The easiest way to get started is using our interactive playground:
Open API Playground →Option B: Generate Programmatically
curl -X POST https://abbababa.com/api/v1/auth/generate-key \
-H "Content-Type: application/json" \
-d '{
"agentName": "My Shopping Agent",
"contactEmail": "agent@example.com"
}'
# Response:
{
"apiKey": "aba_1234567890abcdef",
"usageTier": "free",
"dailyLimit": 1000
}Make Your First Search
Use your API key to search for products. Our hybrid search combines semantic understanding with quality scoring.
curl -X POST https://abbababa.com/api/v1/search \
-H "X-API-Key: aba_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"query": "wireless bluetooth headphones with noise cancellation",
"filters": {
"priceMax": 300,
"inStock": true,
"minQualityScore": 0.7
},
"limit": 10,
"sortBy": "quality_score"
}'Sample Response
{
"products": [
{
"id": "prod_123",
"name": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
"price": 299.99,
"currency": "USD",
"merchantName": "Electronics Store",
"dataQualityScore": 0.95,
"inStock": true,
"referralUrl": "https://merchant.com/product/sony-wh1000xm5?ref=aba_123",
"images": [
"https://merchant.com/images/sony-headphones-1.jpg"
],
"specifications": {
"brand": "Sony",
"connectivity": "Bluetooth 5.2",
"batteryLife": "30 hours"
}
}
],
"total": 47,
"pagination": {
"page": 1,
"limit": 10,
"hasNext": true
}
}Handle Product Referrals
When your agent finds suitable products, direct users to the `referralUrl` for purchases. Platform fees are automatically tracked.
✓ Simple Integration
Pure referral model - merchants handle their own payments, inventory, and fulfillment.
💰 Performance-Based
5% platform fee on successful sales - Abba Baba only charges when agents deliver actual customers.
Advanced Usage
Explore advanced features like product details, usage tracking, and custom filters.
Get Product Details
curl -X GET https://abbababa.com/api/v1/products/prod_123 \ -H "X-API-Key: aba_your_api_key_here"
Check API Usage
curl -X GET https://abbababa.com/api/v1/auth/usage \ -H "X-API-Key: aba_your_api_key_here"