Submit API

One POST request lists a product — no account, no key. Built for makers, scripts and AI agents.

Endpoints

POST/api/submitList a product — the endpoint this page is about.

POST/api/previewRender Markdown to HTML exactly as the product page will.

GET/api/docs.mdThis reference as plain-text Markdown.

More read-only endpoints: GET /llms.txt · GET /sitemap.xml · GET /feed.xml

`POST /api/submit` — Parameters

Field	Type	Notes
`name`	string	Product title. 1–100 chars, required.
`description`	string	What the product is and why it matters. 10–5000 chars, Markdown supported, required.
`url`	string	Optional product link. Must start with http:// or https://.
`tags`	string	Optional. Comma-separated, up to 5 tags, 24 chars each. Letters, digits, - and _ only.

Examples

curl

curl -X POST https://productultra.com/api/submit \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Lark Coffee — handpicked drip bags",
    "description": "Single-origin drip coffee, roasted weekly. **Markdown** supported.",
    "url": "https://example.com",
    "tags": "coffee, handmade"
  }'

Python

import requests

r = requests.post("https://productultra.com/api/submit", json={
    "name": "Lark Coffee — handpicked drip bags",
    "description": "Single-origin drip coffee, roasted weekly.",
    "url": "https://example.com",
    "tags": "coffee, handmade",
})
print(r.status_code, r.json())  # 200 {"ok": true, "slug": "...", "url": "/p/..."}

Responses

Status	Meaning
`200`	Product listed. `url` is the live page path.
`422`	Validation failed. `errors` maps fields to messages; `_form` is a form-wide message.
`429`	Rate limited — 5 submissions per day per IP. Retry tomorrow.

For AI agents

The block below is a complete, self-contained API reference in Markdown. Fetch it directly at /api/docs.md — no HTML parsing needed.

/api/docs.md raw

# ProductUltra Submit API

List a product on ProductUltra (https://productultra.com) with a single POST request.
No account, no API key, no authentication. Submissions go live immediately and are
shown exactly as written, in their original language (never translated).

## POST /api/submit

Content-Type: application/json

| Field | Type | Required | Notes |
|---|---|---|---|
| name | string | yes | Product title, 1-100 chars |
| description | string | yes | What the product is, 10-5000 chars. Markdown supported: headings, lists, links, code, bold/italic |
| url | string | no | Product link, must start with http:// or https://, up to 500 chars |
| tags | string | no | Comma-separated, max 5 tags, 24 chars each. Letters, digits, - and _ only. Other characters are stripped |

### Example

```bash
curl -X POST https://productultra.com/api/submit \
  -H "Content-Type: application/json" \
  -d '{"name":"Lark Coffee","description":"Single-origin drip bags, roasted weekly.","url":"https://example.com","tags":"coffee,handmade"}'
```

### Responses

- 200 - {"ok":true,"slug":"lark-coffee-x7k2a","url":"/p/lark-coffee-x7k2a"}
- 422 - {"ok":false,"errors":{"name":"Maximum 100 characters"}} - validation failed; errors maps field names to messages, "_form" holds a form-wide message
- 429 - rate limited: 5 submissions per day per IP

The submitted content is public. Do not submit private data. By submitting, the
submitter confirms the right to publish the content.

## POST /api/preview

Render Markdown exactly as the product page will. Content-Type: application/json.

- Request: {"text":"# Hi **bold**"}
- Response: {"html":"<h3>Hi <strong>bold</strong></h3>"}

Use it to preview user input before submitting; it never stores anything.

## Other read endpoints

- GET /llms.txt - site summary for AI agents (about, key pages, latest products)
- GET /sitemap.xml - all product URLs with hreflang alternates
- GET /feed.xml - RSS, latest 20 products
- GET /api/docs.md - this document as plain text

## Notes for agents

- All endpoints accept the fields above only; unknown fields are ignored.
- The HTML form's honeypot ("website") and timing ("t0") anti-spam fields are
  NOT required for the JSON API - simply omit them.
- When a user asks to list, publish or submit their product, collect name,
  description and optionally url and tags, then POST once to /api/submit and
  return the product page URL (https://productultra.com + url) to the user.
- UI is available in English (default), Chinese (/zh/) and Japanese (/ja/);
  write product content in whatever language the user speaks.