🚀 Now in Phase 3A - Production Ready with Advanced Features
🤖 Agent API
Getting Started

Getting Started: A Guide for Developers

Last Updated: 2026-01-24

Welcome to the Abba Baba developer platform! This guide will walk you through creating an account, getting your first API key, and making a successful API call in under 5 minutes.

Step 1: Create Your Developer Account

Your Developer Account is your central hub for managing all your AI agents, API keys, and billing.

Follow the prompts to sign up with your email and/or GitHub account. Once registered, you'll be redirected to your Developer Dashboard.

Step 2: Generate Your First Agent API Key

On the Abba Baba platform, every API key represents a unique Agent. Your Developer Account can manage multiple agents, each with its own usage, trust score, and commission tier.

  1. Navigate to the "Agents" section in your Developer Dashboard.
  2. Click "Create New Agent".
  3. Give your agent a descriptive name (e.g., MyShoppingBot-v1, ProductAnalysisAgent).
  4. Click "Create".

Your new agent's API key will be displayed.

aba_live_cloivvj3u0000ql10d1g5f7h

Important: This is the only time your API key will be shown in full. Copy it and store it securely in a secret manager or as an environment variable.

Step 3: Make Your First API Call

You're now ready to make your first API call. The /api/v1/search endpoint is the core of our product discovery engine.

Use the curl command below in your terminal, replacing {YOUR_API_KEY} with the key you just generated.

curl -X POST https://api.abbababa.com/v1/search \
  -H "Authorization: Bearer {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d 
    "query": "organic dark roast coffee beans",
    "limit": 1

Successful Response

If your request is successful, you'll receive a 200 OK response with a JSON body similar to this:

{
  "requestId": "req_clojx5k9p0001ql08y1z2a3bc",
  "results": [
    {
      "id": "prod_clo3h8k2m0000pl07x6y8z1ab",
      "name": "Organic Dark Roast Coffee Beans",
      "merchant": {
        "id": "mer_clo3g1k2m0000ol06w5y7z0ab",
        "companyName": "NEPA Coffee Roasters"
      },
      "price": 18.99,
      "checkoutUrl": "https://nepa-coffee.myshopify.com/cart/variant_id:1?ref=aba_...",
      "relevanceScore": 0.89
    }
  ],
  "billing": {
    "operation": "semanticSearch",
    "tokenCost": 50
  }
}

Step 4: Understanding Tokens

Notice the billing object in the response. All API usage is measured in tokens, which represent the computational cost of an operation. Your "Free" tier plan includes a generous number of tokens, allowing you to build and test your agent without any upfront cost.

For more details on how tokens, billing, and commission sharing work, please refer to our Pricing for Developers guide.

Building Your First Simple AI Agent

To truly start leveraging the Abba Baba platform, you'll want to integrate API calls into an AI agent. A simple AI agent can take a user's query, use our API to find relevant products, and then present those products to the user.

Here's a basic Python example of an agent that performs a product search:

import requests
import os
 
def simple_aba_agent(user_query: str):
    # Retrieve your API Key securely
    api_key = os.getenv("ABA_API_KEY") 
    if not api_key:
        print("Error: ABA_API_KEY environment variable not set.")
        return
 
    url = "https://api.abbababa.com/v1/search"
    headers = {
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    }
    payload = {
        "query": user_query,
        "limit": 3
    }
 
    try:
        response = requests.post(url, headers=headers, json=payload)
        response.raise_for_status() # Raise an HTTPError for bad responses (4xx or 5xx) 
 
        data = response.json() 
        
        print(f"Agent received response for query: '{user_query}'")
        if data and data.get("results"):
            print("Found products:")
            for product in data["results"]:
                print(f"- {product['name']} (Price: ${product['price']}) from {product['merchant']['companyName']}")
                print(f"  Checkout: {product['checkoutUrl']}")
        else:
            print("No products found.")
            
        print(f"\nAPI Call Cost: {data['billing']['tokenCost']} tokens")
 
    except requests.exceptions.HTTPError as errh:
        print(f"Http Error: {errh}")
    except requests.exceptions.ConnectionError as errc:
        print(f"Error Connecting: {errc}")
    except requests.exceptions.Timeout as errt:
        print(f"Timeout Error: {errt}")
    except requests.exceptions.RequestException as err:
        print(f"Something went wrong: {err}")
 
if __name__ == "__main__":
    # Set your API Key as an environment variable: export ABA_API_KEY="aba_live_..."
    simple_aba_agent("comfortable ergonomic office chair")
    print("\n---")
    simple_aba_agent("high-performance gaming laptop under $1500")

How this agent works:

  1. It retrieves your API Key from an environment variable (recommended for security).
  2. It constructs a search query based on user input.
  3. It makes a POST request to our /api/v1/search endpoint.
  4. It processes the JSON response, extracting product details like name, price, merchant, and the crucial checkoutUrl.
  5. It prints a summary of the found products, including a direct link for purchase.

This basic agent can be expanded upon to include more complex logic, integrate with large language models (LLMs) for natural language understanding, and leverage other Abba Baba API capabilities.

Next Steps

Congratulations! You've successfully integrated with the Abba Baba API.

  • Explore the API: Dive into our complete API Endpoints Reference to see everything you can do.
  • Check out Examples: See detailed Request/Response Examples for more complex use cases.
  • Build Your Agent: Start building your AI agent, using our API to power its product discovery capabilities.
🤖 Agent APIAuthentication & Security