# Submit your AI tool to AI SaaS Dir (for AI agents)

AI SaaS Dir (https://aisaasdir.com) is a hand-reviewed directory. Listing is free. This page is for AI agents submitting on a maker's behalf; people can use https://aisaasdir.com/submit.

## 1. Submit

`POST https://aisaasdir.com/api/directory/agent/submit` with a JSON body (`Content-Type: application/json`). Only `url` and `email` are required: we read the homepage and fill in the rest. Send any field to override what we read.

```bash
curl -s https://aisaasdir.com/api/directory/agent/submit \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://your-product.com","email":"maker@your-product.com"}'
```

| Field | Required | Notes |
| --- | --- | --- |
| `url` | yes | The product homepage. |
| `email` | yes | The maker's email; status links and the review result go there. |
| `name` | no | Up to 60 characters. |
| `tagline` | no | One line, up to 120 characters. |
| `description` | no | Up to 1000 characters. |
| `category` | no | A category slug from the list below. |
| `pricing` | no | `free`, `freemium` or `paid`. |

The reply (`data`) has the `token` (store it: it is shown once), the `badge` HTML, the `verify` call and `next`, the remaining steps in plain language.

## 2. Add the badge

Free listings need our badge on the product's homepage: the `badge.html` from the reply (`badge.htmlDark` on a dark page; it's the same badge drawn for dark backgrounds), or any normal link to https://aisaasdir.com. The footer is the usual place. It must be in the HTML the server sends (not only rendered by JavaScript) and must not have `rel="nofollow"`, `"ugc"` or `"sponsored"`. Every product uses the same badge. Then deploy the site. With the badge in place, the listing links to the product with a followed (dofollow) link.

## 3. Verify

```bash
curl -s https://aisaasdir.com/api/directory/submissions/verify \
  -H 'Content-Type: application/json' \
  -d '{"token":"<token>"}'
```

An error `badge_missing` comes with `data.evidence.error` (`not_found` or `nofollow`): fix the page and try again, at most once every 10 seconds.

## 4. Review

An editor reviews every listing within 7 days and emails the result. Approved listings join a publishing queue (a few go live each day, in order); the maker gets the expected date by email, and another email when it is live. Check status any time: `POST https://aisaasdir.com/api/directory/submissions/status` with `{"token":"<token>"}`, or give the maker the `statusUrl` from the reply. The badge is checked again before the listing goes live and weekly after; if it is removed, the listing's link becomes nofollow.

## Errors

Errors are `{ "code": -1, "message": "<code>" }`:

- `invalid:<field>`, `invalid_url`: fix the request.
- `missing:name,tagline`: we couldn't read the homepage; send these fields.
- `already_listed`, `already_submitted`: this domain is listed or in review already.
- `not_allowed`: the product is outside what we list (adult, gambling, illegal or malicious sites).
- `rate_limited`, `busy`: wait and retry later.
- `email_limit`: this email has made 10 submissions in the last 24 hours; try again tomorrow.

## Categories

- `ai-chatbot`: Assistants & Agents › AI Chatbot
- `ai-agent`: Assistants & Agents › AI Agent
- `ai-workflow-automation`: Assistants & Agents › AI Workflow Automation
- `ai-writer`: Writing & Content › AI Writer
- `ai-paraphraser`: Writing & Content › AI Paraphraser
- `ai-grammar-checker`: Writing & Content › AI Grammar Checker
- `ai-translator`: Writing & Content › AI Translator
- `ai-summarizer`: Writing & Content › AI Summarizer
- `ai-detector`: Writing & Content › AI Detector
- `ai-humanizer`: Writing & Content › AI Humanizer
- `ai-seo-tools`: Marketing › AI SEO Tools
- `ai-social-media`: Marketing › AI Social Media
- `ai-ad-creative`: Marketing › AI Ad Creative
- `ai-sales-assistant`: Sales › AI Sales Assistant
- `ai-lead-generation`: Sales › AI Lead Generation
- `ai-customer-support`: Customer Support › AI Customer Support
- `ai-meeting-assistant`: Productivity › AI Meeting Assistant
- `ai-note-taker`: Productivity › AI Note Taker
- `ai-presentation-maker`: Productivity › AI Presentation Maker
- `ai-pdf-tools`: Productivity › AI PDF & Documents
- `ai-email-assistant`: Productivity › AI Email Assistant
- `ai-data-analysis`: Business & Operations › AI Data Analysis
- `ai-recruiting`: Business & Operations › AI Recruiting
- `ai-accounting`: Business & Operations › AI Accounting & Finance
- `ai-legal`: Business & Operations › AI Legal
- `ai-code-assistant`: Development › AI Code Assistant
- `ai-app-builder`: Development › AI App Builder
- `ai-website-builder`: Development › AI Website Builder
- `ai-developer-tools`: Development › AI Developer Tools
- `ai-search-engine`: Search & Research › AI Search Engine
- `ai-research-assistant`: Search & Research › AI Research Assistant
- `ai-image-generator`: Image › AI Image Generator
- `ai-photo-editor`: Image › AI Photo Editor
- `ai-background-remover`: Image › AI Background Remover
- `ai-image-upscaler`: Image › AI Image Upscaler
- `ai-logo-generator`: Image › AI Logo Generator
- `ai-headshot-generator`: Image › AI Headshot Generator
- `ai-graphic-design`: Design & 3D › AI Graphic Design
- `ai-interior-design`: Design & 3D › AI Interior Design
- `ai-3d-generator`: Design & 3D › AI 3D Model Generator
- `ai-video-generator`: Video › AI Video Generator
- `ai-video-editor`: Video › AI Video Editor
- `ai-avatar-video`: Video › AI Avatar Video
- `text-to-speech`: Voice & Music › Text to Speech
- `ai-voice-cloning`: Voice & Music › AI Voice Cloning
- `ai-music-generator`: Voice & Music › AI Music Generator
- `ai-transcription`: Voice & Music › AI Transcription
- `ai-tutor`: Education › AI Tutor
- `ai-study-tools`: Education › AI Study Tools
