Skip to main content

Developer Tools

SDKs

Official client libraries for the AaaS Knowledge Index API. Download a generated SDK or use the code examples below to get started.

TS

TypeScript / Node.js

aaas-sdk.ts

Full-featured TypeScript client with complete type definitions. Works with Node.js, Deno, Bun, and browser environments.

PY

Python

aaas_sdk.py

Python client using the requests library. Supports all API endpoints with typed method signatures and docstrings.

TypeScript / Node.js

Installation

npm install --save-dev aaas-sdk
# Or download directly:
curl -O https://aaas.blog/api/sdk/typescript

Quick Start

import { AaaSClient } from "./aaas-sdk";

const client = new AaaSClient({
  apiKey: "aaas_your_key_here",
});

// List all tools
const tools = await client.listEntities({ type: "tool", limit: 10 });
console.log(tools.data);

// Search for entities
const results = await client.search({ q: "langchain" });
console.log(results.data);

// Get leaderboard
const board = await client.getLeaderboard("all", 25);
console.log(board.data);

// Submit a new entity
const submission = await client.submitEntity({
  name: "My Tool",
  type: "tool",
  description: "An amazing AI tool",
  provider: "Acme Corp",
  category: "ai-tools",
  tags: ["ai", "automation"],
});
console.log(submission.id);

Python

Installation

pip install requests
# Download the SDK:
curl -O https://aaas.blog/api/sdk/python

Quick Start

from aaas_sdk import AaaSClient

client = AaaSClient(api_key="aaas_your_key_here")

# List all tools
tools = client.list_entities(type="tool", limit=10)
print(f"Found {tools['count']} tools")

# Search for entities
results = client.search(q="langchain")
for entity in results["data"]:
    print(f"  {entity['name']} — {entity['scores']['composite']}")

# Get leaderboard
board = client.get_leaderboard("all", limit=25)
for i, entity in enumerate(board["data"], 1):
    print(f"  #{i} {entity['name']}")

# Submit a new entity
submission = client.submit_entity(
    name="My Tool",
    type="tool",
    description="An amazing AI tool",
    provider="Acme Corp",
    category="ai-tools",
    tags=["ai", "automation"],
)
print(f"Submitted: {submission['id']}")

OpenAPI Specification

Machine-readable API specification (OpenAPI 3.0.3). Use with Swagger UI, Postman, or any OpenAPI-compatible tool.