API Reference
Complete reference for all Abba Baba API endpoints, request/response schemas, and error codes.
Base URL & Authentication
Base URL
https://abbababa.com/api/v1Authentication
X-API-Key: aba_your_api_keyAuthentication
POST
/auth/generate-keyGenerate a new API key for agent authentication.
Request Body
{
"agentName": "string", // Required: Name of your AI agent
"contactEmail": "string" // Required: Contact email for account
}Response
{
"apiKey": "aba_1234567890abcdef",
"usageTier": "free",
"dailyLimit": 1000,
"createdAt": "2026-01-14T12:00:00Z"
}GET
/auth/usageGet current API usage statistics for your key.
Response
{
"usageTier": "free",
"requestsToday": 45,
"requestsThisMonth": 850,
"dailyLimit": 1000,
"monthlyLimit": 10000,
"lastRequest": "2026-01-14T12:30:00Z"
}Search
POST
/searchSearch products using semantic search, text matching, and advanced filters. Our hybrid algorithm combines vector similarity (50%), quality scores (30%), and text relevance (20%).
Request Body
{
"query": "string", // Required: Search query
"filters": { // Optional: Search filters
"priceMin": 0, // Minimum price
"priceMax": 1000, // Maximum price
"currency": "USD", // Currency filter
"inStock": true, // Only in-stock products
"categories": ["electronics", "audio"],
"certifications": ["fcc_approved"],
"minQualityScore": 0.7, // 0.0 to 1.0
"merchantIds": ["merchant_123"]
},
"sortBy": "quality_score", // relevance|quality_score|price|name
"sortOrder": "desc", // asc|desc
"page": 1, // Page number (1-based)
"limit": 10 // Results per page (max 50)
}Response
{
"products": [
{
"id": "prod_123",
"name": "Sony WH-1000XM5 Headphones",
"description": "Industry-leading noise canceling...",
"price": 299.99,
"compareAtPrice": 399.99,
"currency": "USD",
"sku": "SONY-WH1000XM5-B",
"merchantId": "merchant_456",
"merchantName": "Electronics Store",
"dataQualityScore": 0.95,
"inStock": true,
"inventoryQuantity": 15,
"categories": ["electronics", "audio", "headphones"],
"tags": ["noise-canceling", "wireless", "bluetooth"],
"referralUrl": "https://store.com/product/sony?ref=aba_123",
"images": [
"https://store.com/images/sony-headphones-1.jpg"
],
"specifications": {
"brand": "Sony",
"model": "WH-1000XM5",
"connectivity": "Bluetooth 5.2",
"batteryLife": "30 hours",
"weight": "250g"
},
"certifications": ["fcc_approved", "ce_marked"],
"lastSynced": "2026-01-14T12:00:00Z"
}
],
"total": 47,
"pagination": {
"page": 1,
"limit": 10,
"totalPages": 5,
"hasNext": true,
"hasPrev": false
},
"searchMeta": {
"query": "wireless noise canceling headphones",
"searchTimeMs": 45,
"algorithmWeights": {
"semantic": 0.5,
"quality": 0.3,
"textMatch": 0.2
}
}
}Products
GET
/products/{id}Get detailed information about a specific product.
Path Parameters
id (string): Product IDResponse
{
"product": {
"id": "prod_123",
"name": "Sony WH-1000XM5 Headphones",
"description": "Industry-leading noise canceling with...",
"price": 299.99,
"compareAtPrice": 399.99,
"currency": "USD",
"sku": "SONY-WH1000XM5-B",
"barcode": "1234567890123",
"weight": {
"value": 250,
"unit": "g"
},
"dimensions": {
"length": 7.5,
"width": 3.0,
"height": 9.5,
"unit": "inch"
},
"merchantId": "merchant_456",
"merchantName": "Electronics Store",
"dataQualityScore": 0.95,
"qualityIssues": [],
"inStock": true,
"inventoryQuantity": 15,
"allowOverselling": false,
"lowStockThreshold": 10,
"categories": ["electronics", "audio", "headphones"],
"tags": ["noise-canceling", "wireless", "bluetooth"],
"referralUrl": "https://store.com/product/sony?ref=aba_123",
"images": [
"https://store.com/images/sony-headphones-1.jpg",
"https://store.com/images/sony-headphones-2.jpg"
],
"specifications": {
"brand": "Sony",
"model": "WH-1000XM5",
"connectivity": "Bluetooth 5.2",
"batteryLife": "30 hours",
"chargingTime": "3 hours",
"frequency": "4Hz-40,000Hz",
"impedance": "16 ohm",
"weight": "250g"
},
"certifications": ["fcc_approved", "ce_marked", "energy_star"],
"seoTitle": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
"seoDescription": "Experience the best noise canceling...",
"createdAt": "2026-01-10T08:00:00Z",
"updatedAt": "2026-01-14T12:00:00Z",
"lastSynced": "2026-01-14T12:00:00Z"
}
}Error Responses
Standard Error Format
{
"error": "invalid_api_key",
"message": "The provided API key is invalid or expired",
"code": 401,
"timestamp": "2026-01-14T12:00:00Z"
}Common Error Codes
| Code | Error | Description |
|---|---|---|
| 400 | invalid_request | Malformed request or missing required parameters |
| 401 | invalid_api_key | API key is missing, invalid, or expired |
| 403 | rate_limit_exceeded | Daily or per-minute rate limit exceeded |
| 404 | not_found | Resource not found |
| 500 | internal_error | Internal server error |
Rate Limits & Best Practices
Current Limits
- • Free Tier: 1,000 requests per day
- • No per-minute limits (fair use policy)
- • Search results: Max 50 per request
- • Enterprise tiers: Available on request
Best Practices
- • Cache search results when appropriate
- • Use pagination for large result sets
- • Implement exponential backoff for retries
- • Monitor usage with
/auth/usage