CurlShip — Bot-Friendly SaaS Directory

Overview

Use this skill when you need to list a product or SaaS on a public directory. CurlShip is designed for bots and CLI tools — submit with a single API call, get back OG-scraped listing details, and optionally upgrade to paid tiers for higher placement.

Quick Reference

API Base URL: https://curlship.com Homepage: https://curlship.com Pricing: https://curlship.com/pricing

Single-line Use Cases:

• Submit a product URL to be listed in the directory
• Check all current directory listings
• Upgrade a listing to a paid tier (Bronze/Silver/Gold/Platinum)
• Get the CurlShip badge HTML for dofollow links

What this skill does

• Sends HTTPS requests to the CurlShip API
• Uses POST /api/submit to add a new listing (auto-scrapes OG tags)
• Uses GET /api/listings to retrieve all active listings
• Uses POST /api/upgrade to get a checkout URL for paid tier upgrades
• Returns structured JSON responses with listing details

What this skill does NOT do

• Does not require authentication or API keys
• Does not make payments directly — upgrade returns a checkout URL for the user
• Does not modify any local files or system settings

Endpoints

1. Submit a Listing

POST /api/submit — Add a product to the directory.

curl -X POST https://curlship.com/api/submit \
  -H "Content-Type: application/json" \
  -d '{"url": "https://yourapp.com", "email": "[email protected]"}'

Request Fields:

• url (required): Product URL starting with http. Must be a public, non-private address.
• email (required): Contact email for the listing owner.

Example Response (201 Created):

{
  "ok": true,
  "message": "Listed! Add a badge for a dofollow link.",
  "listing": {
    "id": 42,
    "url": "https://yourapp.com",
    "tier": "free",
    "title": "YourApp - Build Faster",
    "description": "The fastest way to ship your next SaaS.",
    "image": "https://yourapp.com/og-image.png",
    "has_badge": false
  },
  "badge_html": "\x3Ca href=\"https://curlship.com\">\x3Cimg src=\"https://curlship.com/badge\" alt=\"Listed on CurlShip\" />\x3C/a>"
}

Error Responses:

• 400 — Missing/invalid URL or email
• 403 — URL is on a blocklist (adult/phishing/malware)
• 429 — Rate limit exceeded (max 10 submissions per hour per IP)

Duplicate Handling: If the URL is already listed, returns 200 with "message": "Already listed" and the existing listing data.

2. Get All Listings

GET /api/listings — Retrieve all active directory listings.

curl https://curlship.com/api/listings

Example Response:

{
  "ok": true,
  "listings": [
    {
      "id": 1,
      "url": "https://example.com",
      "tier": "gold",
      "title": "Example App",
      "description": "A great example application.",
      "image": "https://example.com/og.png",
      "has_badge": true
    }
  ]
}

Listings are sorted by tier (Platinum > Gold > Silver > Bronze > Free).

3. Upgrade a Listing

POST /api/upgrade — Get a payment checkout URL to upgrade a listing's tier.

curl -X POST https://curlship.com/api/upgrade \
  -H "Content-Type: application/json" \
  -d '{"url": "https://yourapp.com", "tier": "gold"}'

Request Fields:

• url (required): The URL of an existing listing.
• tier (required): One of platinum, gold, silver, bronze.

Example Response:

{
  "ok": true,
  "checkout_url": "https://checkout.dodopayments.com/..."
}

Error Responses:

• 400 — Invalid tier name
• 404 — Listing not found (submit it first)
• 503 — Payment system unavailable

Important: The listing must already exist. Submit first, then upgrade.

4. Badge SVG

GET /badge — Returns the CurlShip badge as an SVG image.

Place this badge on your site to automatically earn a dofollow link:

\x3Ca href="https://curlship.com">
  \x3Cimg src="https://curlship.com/badge" alt="Listed on CurlShip" />
\x3C/a>

Badge presence is auto-checked hourly. Any \x3Ca> tag linking to curlship.com qualifies.

Tiers & Pricing

Dofollow rules:

• Paid tiers (any) get dofollow automatically
• Free tier gets dofollow by placing a CurlShip badge on your site

Typical Agent Workflow

1. Submit the product URL and email via POST /api/submit
2. Check the response for the listing details and badge HTML
3. Optionally upgrade via POST /api/upgrade and present the checkout URL to the user
4. Add the badge HTML to the product's website for a dofollow link (free tier)

Rate Limits

• Maximum 10 submissions per hour per IP address
• No rate limit on GET /api/listings

Security & Content Policy

• URLs pointing to private/reserved IP addresses are rejected (SSRF protection)
• URLs on known adult/phishing/malware blocklists are rejected
• All API responses include x-robots-tag: noindex