Listings

Submit a product listing

Add a product to the directory. Goes live instantly — no review queue. One listing per root domain. Rate limit: 10 submissions/hour per IP.

Free tier gets a nofollow link; add the badge for dofollow. Pass tier to start a paid checkout instead: the listing is created (free until paid) and the response carries a checkout_url. tier: "featured" bids on the auction spot above Platinum — amount_usd optionally sets the bid, defaulting to the current minimum. If the payment system is unavailable the listing still lands as free and the response says so with checkout_url: null. An already-listed URL with a paid tier gets an upgrade checkout instead of a dead end.

post/api/submit

Request

  • Base URL: https://curlship.com
  • URL: https://curlship.com/api/submit
  • Auth: none declared

Request body

urlstring uri required
emailstring email required
tier'bronze' | 'bronze_lifetime' | 'silver' | 'gold' | 'platinum' | 'featured'

Optional. Omit for the free tier. "featured" bids on the auction spot.

amount_usdnumber

Featured only — the bid in USD, defaulting to the current minimum. Same rules as POST /api/feature.

Example request

{
  "url": "https://yourapp.com",
  "email": "you@email.com",
  "amount_usd": 51
}

Response

Already listed (idempotent)

object required

Changes

No recorded changes to this operation across all 1 revision of this API.