# CurlShip

> Bot-friendly SaaS directory. Submit your product with a single curl command.

## What is CurlShip?
CurlShip is a SaaS directory that welcomes automated submissions.
Unlike other directories that gate behind manual forms, CurlShip lets you
submit your product with a simple curl/API call.
Bots, agents, and AI are explicitly welcome — no CAPTCHA, no login, no approval queue.

## API (all endpoints accept and return JSON over HTTPS)
OpenAPI 3.1 spec: https://curlship.com/openapi.json
Interactive docs (Swagger UI): https://curlship.com/docs

Submit a listing (goes live instantly):
  POST https://curlship.com/api/submit
  Body: {"url": "https://yourapp.com", "email": "you@email.com"}
  Optional: add "tier": "bronze|bronze_lifetime|silver|gold|platinum" for a paid tier.

Verify your badge on demand (upgrade Free listing to dofollow immediately):
  POST https://curlship.com/api/verify-badge
  Body: {"url": "https://yourapp.com"}
  Returns: {"ok": true, "has_badge": true, "dofollow": true, ...}
  Re-fetches your listed site and looks for a link back to curlship.com.
  This is the manual trigger for the otherwise-hourly badge check.

Upgrade an existing listing to a paid tier:
  POST https://curlship.com/api/upgrade
  Body: {"url": "https://yourapp.com", "tier": "gold"}

List all active listings (JSON):
  GET https://curlship.com/api/listings

Fetch one listing by id (JSON):
  GET https://curlship.com/api/listing/2142

Change your listing's URL yourself (no account, no support email):
  Guide for humans: https://curlship.com/edit
  POST https://curlship.com/api/edit-request
  Body: {"listing_id": 2142, "url": "https://new-url.example/", "proof": "email"}
  proof "email"  — we mail a one-time confirmation link to the registered address.
  proof "domain" — we return a token you publish at
                   /.well-known/curlship-verify.txt (or as a
                   <meta name="curlship-verify" content="..."> tag) on BOTH the
                   currently listed site AND the new one, then you call
                   POST https://curlship.com/api/edit-confirm
                   Body: {"request_id": 7, "token": "..."}
  Publishing the token on the new domain alone is never enough — that proves
  you own the destination, not the listing.
  Changing the registered email always needs proof "email".
  Poll a request: GET https://curlship.com/api/edit-request/7
  Every applied change is logged and mailed to the registered address with an
  undo link, and a URL change resets the badge until it is re-verified.

## Tiers
- Platinum ($49/year) — top of directory, dofollow link
- Gold ($3/mo) — above silver/bronze, dofollow link
- Silver ($2/mo) — above bronze/free, dofollow link
- Bronze ($1/mo) — above free, dofollow link
- Bronze Lifetime ($30 one-time) — Bronze forever, no subscription
- Free ($0) — nofollow by default, add badge for dofollow

## Pages
- https://curlship.com/ — Directory homepage with lazy-loaded listings
- https://curlship.com/pricing — Pricing details
- https://curlship.com/about — About CurlShip and founder Marcin Dudek
- https://curlship.com/privacy — Privacy notice
- https://curlship.com/terms — Terms of service
- https://curlship.com/badge — How to add the badge + verify it instantly
- https://curlship.com/edit — How to change a listing's URL or email (ownership proofs)
- https://curlship.com/docs — Interactive API reference (Swagger UI)
- https://curlship.com/sitemap — Human-readable map of the whole site

## Feeds
- https://curlship.com/feed.xml — Atom feed of the latest listings
- https://curlship.com/sitemap.xml — Full sitemap