Submit your AI tool to Aidirs using code. Learn how developers can automate submissions with the official SDK instead of manual forms.
Submit your AI tool to Aidirs for editorial review, a structured listing, and exposure to thousands of AI enthusiasts.
Launching an AI tool today is easier than ever. But getting it discovered is still one of the biggest challenges for founders.
Most AI builders eventually realize they need to submit their product to multiple directories and discovery platforms. These listings help users find new tools and improve long-term search visibility.
However, the process is often repetitive and manual. You open a submission form, paste your URL, write a description, upload an icon, and repeat the same steps across multiple platforms.
If you are launching an AI product, you will likely submit it to several AI directories. Some founders maintain a list of platforms to submit to. You can explore a curated list of these platforms here: AI Directory Backlinks.
Each submission typically requires the same information:
Doing this once is fine. Doing it across dozens of directories becomes time-consuming. For developers who already automate deployments and builds, this part of the workflow still feels surprisingly manual.
To make submissions easier, we built the Aidirs SDK. Instead of filling out a form, you can submit your tool programmatically. All you need is your product URL. The SDK automatically generates the tool name, description, icon, and metadata using AI.
Install the SDK:
pnpm add @aidirs/sdk
Submit a tool in just a few lines:
typescript
import { Aidirs } from "@aidirs/sdk";
const client = new Aidirs({ apiKey: process.env.AIDIRS_API_KEY! });
// Check your credits
const { credits, plan } = await client.credits();
console.log(`Credits: ${credits}, Plan: ${plan}`);
// Submit a tool — AI auto-generates name, description, icon
const result = await client.submit({
url: "https://your-ai-tool.com",
plan: "starter",
});
console.log(result);
// { status: "success", url: "https://aidirs.best/item/your-ai-tool", creditsUsed: 1, creditsRemaining: 9 }
You can read the full API documentation here: Aidirs API Documentation.
If you manage multiple AI tools, the SDK supports batch submissions. It processes tools sequentially, stops early when credits run out, and auto-retries on rate limits.
typescript
const { results, errors } = await client.batchSubmit([
{ url: "https://tool-a.com", plan: "starter" },
{ url: "https://tool-b.com", plan: "pro" },
{ url: "https://tool-c.com", plan: "starter" },
]);
console.log(`Submitted: ${results.length}, Errors: ${errors.length}`);
Each submission consumes credits based on the plan level:
Purchase credits from the pricing page.
The SDK provides typed error handling so you always know what went wrong:
typescript
import { Aidirs, AidirsAPIError } from "@aidirs/sdk";
try {
await client.submit({ url: "https://example.com", plan: "pro" });
} catch (err) {
if (err instanceof AidirsAPIError) {
console.log(err.status); // 402
console.log(err.body); // { error: "Insufficient credits", required: 2, available: 1 }
}
}
Common status codes:
The SDK is especially helpful if you:
Many indie makers and AI founders maintain multiple products, which makes automation particularly useful.
If you prefer the standard process, you can still submit your tool through the form.
For developers who want to automate, get your API key from the dashboard and start submitting.
Whether you submit your tool manually or through code, the goal remains the same — helping useful AI products become easier to find.