@aidirs/sdk

Official SDK for the Aidirs API — submit AI tools programmatically.

Install

pnpm add @aidirs/sdk

Quick Start

import { Aidirs } from "@aidirs/sdk";

const client = new Aidirs({ apiKey: process.env.AIDIRS_API_KEY! });

// Check credits
const { credits, plan } = await client.credits();

// Submit a tool
const result = await client.submit({
  url: "https://example.com",
  plan: "pro", // starter (1 credit) | pro (2 credits)
  addonIds: ["hero_sponsor_30d"], // optional promotion add-ons
});

console.log(result);
// { status, url, reviewStatus, creditsUsed, creditsRemaining }

Batch Submit

const { results, errors } = await client.batchSubmit([
  { url: "https://tool-a.com", plan: "starter" },
  { url: "https://tool-b.com", plan: "pro", addonIds: ["sidebar_spotlight_30d"] },
]);

• Stops early on 402 (insufficient credits)
• Auto-retries once on 429 (rate limit)

API Reference

| Method | Description | |--------|-------------| | client.credits() | Get current credit balance and plan | | client.submit(options) | Submit a single AI tool | | client.batchSubmit(items) | Submit multiple tools sequentially |

Error Handling

import { Aidirs, AidirsAPIError } from "@aidirs/sdk";

try {
  await client.submit({
    url: "https://example.com",
    plan: "pro",
    addonIds: ["hero_sponsor_7d"],
  });
} catch (err) {
  if (err instanceof AidirsAPIError) {
    console.log(err.status); // 402
    console.log(err.body);   // { error: "Insufficient credits", required: 11, available: 1 }
  }
}

Links

• API Documentation
• API Keys & Credits

License

MIT