Why automate AI tool submissions
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.
The problem with manual submissions
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:
- Product URL
- Tool name and description
- Icon or logo
- Category and tags
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.
Submitting an AI tool with code
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.
Batch submissions
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}`);
Three plan levels
Each submission consumes credits based on the plan level:
- Starter (1 credit) — Basic listing with dofollow backlinks
- Pro (2 credits) — Featured listing with social sharing
- Sponsor (6 credits) — Featured + 7-day site-wide placement
Purchase credits from the pricing page.
Error handling
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:
- 400 — Invalid request body or URL
- 401 — Missing or invalid API key
- 402 — Insufficient credits
- 409 — URL already submitted
- 429 — Rate limit exceeded (10 requests/minute)
When programmatic submission is useful
The SDK is especially helpful if you:
- Launch multiple AI tools
- Maintain several projects
- Manage products for clients
- Prefer automation over manual form filling
Many indie makers and AI founders maintain multiple products, which makes automation particularly useful.
Get started
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.
