llms.txt
# Submitator API
> The Submitator API launches your clients' products on up to 100 directories each, under your agency's brand.
Each link below is the Markdown of a page of https://submitator.com/docs; the same URL without .md is the page. Every page in one file: https://submitator.com/llms-full.txt. The OpenAPI 3.1 document of the API: https://api.submitator.com/v1/openapi.json.
## Get started
- [Introduction](https://submitator.com/docs.md): The Submitator API launches your clients' products on up to 100 directories each, under your agency's brand.
- [Quickstart](https://submitator.com/docs/quickstart.md): Get a free test key, launch a client's project in test mode and receive a signed webhook when one of its listings goes live.
- [How it works](https://submitator.com/docs/how-it-works.md): The life of a project and its listings, every status, how long it takes, and the words these docs use.
- [Authentication](https://submitator.com/docs/authentication.md): Send your secret key in the Authorization header, from your server only.
- [Test mode](https://submitator.com/docs/test-mode.md): A free sbm_test_ key runs the API on test data. Listings move on their own in about 15 minutes, and nothing is submitted or spent.
## Guides
- [Onboard a client's product](https://submitator.com/docs/guides/onboard-a-clients-product.md): Turn a client's URL into a project that is ready to launch, with what we read from the site, images, a contact email and your own references.
- [Launch and track](https://submitator.com/docs/guides/launch-and-track.md): Preview a launch, spend 1 launch on the directories a project qualifies for or on your own pick, and follow each listing until it is live.
- [Reach more directories](https://submitator.com/docs/guides/reach-more-directories.md): See what keeps a project from more directories, unlock them with the badge, competitors, a promo code and the audience marks, and fill the free allowance after launch with your own pick, article platforms included.
- [Install the badge](https://submitator.com/docs/guides/install-the-badge.md): Some directories list a product only while their badge is on its site. Get the install kit, forward it to your client, check the install and verify it.
- [Receive webhooks](https://submitator.com/docs/guides/receive-webhooks.md): Add an HTTPS endpoint, check the signature of every delivery, answer within 10 seconds, and handle repeats and order.
- [Keep your data in sync](https://submitator.com/docs/guides/keep-your-data-in-sync.md): Mirror projects and listings in your own system with no gaps and no doubles, by reading the events feed from a cursor, letting webhooks say when, and retrying writes with Idempotency-Key.
- [Reports for clients](https://submitator.com/docs/guides/reports-for-clients.md): Build a PDF or XLSX report of a project's listings under your agency's name, wait until it is ready, and download it within 7 days.
- [Go-live checklist](https://submitator.com/docs/guides/go-live-checklist.md): Move an integration from test mode to live without surprises, from keys and endpoints to your clients' real sites and the first real launch.
## API reference
- [Overview](https://submitator.com/docs/api.md): Every route of the v1 API on one screen, and the rules all of them share.
- [Basics](https://submitator.com/docs/api/basics.md): Check your key, read your account and download this reference.
- [Projects](https://submitator.com/docs/api/projects.md): A project is one of your client's products.
- [Launch](https://submitator.com/docs/api/launch.md): Preview, pick, launch and follow the listings.
- [Badge](https://submitator.com/docs/api/badge.md): Some directories list a product only while their badge shows on the product's site.
- [Reports](https://submitator.com/docs/api/reports.md): PDF and XLSX reports of a project's listings, prepared under your agency's name.
- [Events](https://submitator.com/docs/api/events.md): Every change to your projects, listings and reports, in order.
- [Webhooks](https://submitator.com/docs/api/webhooks.md): Events pushed to your HTTPS endpoint as they happen.
- [Directories](https://submitator.com/docs/api/directories.md): The catalog a launch picks from, highest Domain Rating first.
- [Test mode](https://submitator.com/docs/api/test-mode.md): With a sbm_test_ key every call works as in live mode, on separate data, and nothing is submitted or spent.
- [Share links](https://submitator.com/docs/api/share-links.md): A read-only page that shows your client how their launch is going, in your agency's name and colors.
- [Logins](https://submitator.com/docs/api/logins.md): The accounts created for your client on directories that need one: where each signs in, its email and username, whether it is ready, and the one password they all use.
## Webhooks
- [Signatures](https://submitator.com/docs/webhooks/signatures.md): Every delivery is signed as Standard Webhooks describes. Check it with an official library and your whsec_ secret, or with HMAC-SHA256 in any language.
- [Event types](https://submitator.com/docs/webhooks/event-types.md): The 15 events a webhook endpoint can receive, when each one is sent, and what its data holds.
- [Retries and failures](https://submitator.com/docs/webhooks/retries-and-failures.md): Answer 2xx within 10 seconds. A delivery is tried up to 7 times over about 33 hours, and an endpoint that fails for 72 hours is disabled until you enable it again.
## Errors
- [Error format](https://submitator.com/docs/error-format.md): Every 4xx and 5xx response has one shape. Branch on the code, show the message, log the request id.
- [Error codes](https://submitator.com/docs/errors.md): Every error code the API returns, with its HTTP status, what happened and how to fix it.
## Resources
- [Rate limits](https://submitator.com/docs/rate-limits.md): 3,600 requests per UTC hour for each account and mode, a few operations with limits of their own, and how to read the headers.
- [Versioning](https://submitator.com/docs/versioning.md): v1 has been generally available since 2026-10-07. Breaking changes only ever arrive in a new version, /v2, with 6 months of overlap.
- [Changelog](https://submitator.com/docs/changelog.md): Every change to the v1 API that your code can notice, newest first, dated by the day it shipped.
- [For AI agents](https://submitator.com/docs/for-ai-agents.md): Every page as Markdown, all the docs in one file and the OpenAPI document, for AI assistants and coding agents that build with the API.
- [Support](https://submitator.com/docs/support.md): Write to support@submitator.com with the request id, and never with your key.
