# 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|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

## 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
- 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/badge — How to add the badge + verify it instantly
- 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