CurlShip

Take the Featured spot. It sits above every listing. The minimum right now is $51. Always dofollow. One-time payment, no refund when someone outbids you. The product must already be listed. Omit amount_usd to bid $51.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "URL of a listing that is already on the directory."
    },
    "amount_usd": {
      "type": "number",
      "description": "Bid in USD. Omit to bid the minimum (51)."
    }
  },
  "required": [
    "url"
  ]
}

Who holds the Featured spot, and the current minimum bid.

{
  "type": "object",
  "properties": {}
}

List a product. It goes live immediately. One listing per root domain. https://yourapp.com is the documentation placeholder and is refused.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "tier": {
      "type": "string",
      "enum": [
        "bronze",
        "bronze_lifetime",
        "silver",
        "gold",
        "platinum"
      ],
      "description": "Omit for the free tier. For the spot above every tier use bid_featured."
    }
  },
  "required": [
    "url",
    "email"
  ]
}

Checkout URL for a paid tier on a listing that already exists. Featured is bid_featured, not this.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    },
    "tier": {
      "type": "string",
      "enum": [
        "bronze",
        "bronze_lifetime",
        "silver",
        "gold",
        "platinum"
      ]
    }
  },
  "required": [
    "url",
    "tier"
  ]
}

Re-read title, description, and image from the listed page. Send listing_id and proof only. The first confirm previews; send apply back to save.

{
  "type": "object",
  "properties": {
    "listing_id": {
      "type": "integer"
    },
    "proof": {
      "type": "string",
      "enum": [
        "email",
        "domain"
      ]
    }
  },
  "required": [
    "listing_id",
    "proof"
  ]
}

Point an existing listing at a new URL. One listing per root domain, so this is how a second page replaces the first.

{
  "type": "object",
  "properties": {
    "listing_id": {
      "type": "integer"
    },
    "url": {
      "type": "string"
    },
    "proof": {
      "type": "string",
      "enum": [
        "email",
        "domain"
      ]
    }
  },
  "required": [
    "listing_id",
    "url",
    "proof"
  ]
}

Take a free listing off the directory. Send remove true and no url or email. A paid listing or the Featured holder is refused.

{
  "type": "object",
  "properties": {
    "listing_id": {
      "type": "integer"
    },
    "remove": {
      "type": "boolean",
      "const": true
    },
    "proof": {
      "type": "string",
      "enum": [
        "email",
        "domain"
      ]
    }
  },
  "required": [
    "listing_id",
    "remove",
    "proof"
  ]
}

Apply an edit request. A refresh needs a second call with the apply digest from the preview.

{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "integer"
    },
    "token": {
      "type": "string"
    },
    "apply": {
      "type": "string",
      "description": "Digest from the refresh preview. Omit for a URL change or a removal."
    }
  },
  "required": [
    "request_id",
    "token"
  ]
}

Re-check the listed site for a link to curlship.com. A free listing with the badge becomes dofollow.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    }
  },
  "required": [
    "url"
  ]
}

Active listings as JSON. No query returns every listing, in the same order as before. Optional query parameters: limit, offset, q, and since. q matches the title, description, or URL. since is an ISO timestamp; listings created at or after it are kept. Each listing includes created_at. There is no category or tag field.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 0,
      "description": "Max listings. 50 with offset, 100 with q, when omitted."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "How many matching listings to skip."
    },
    "q": {
      "type": "string",
      "description": "Substring of the title, description, or URL."
    },
    "since": {
      "type": "string",
      "description": "ISO timestamp. Keep listings created at or after this moment."
    }
  }
}

Listing counts and the Ahrefs Domain Rating.

{
  "type": "object",
  "properties": {}
}

Active listings added per UTC day — the zero-filled series behind the public /stats page. One entry per calendar day from the first listing to today, each with added and the cumulative running total.

{
  "type": "object",
  "properties": {
    "range": {
      "type": [
        "string",
        "integer"
      ],
      "description": "\"all\" (default) for the whole series, or a day count 1-3650 for the last N days."
    }
  }
}

The site's Ahrefs Domain Rating over time — the series behind /stats#dr. Every recorded reading, one per UTC day, plus the current value, the last step (change vs the most recent different reading) and the growth since the first reading.

{
  "type": "object",
  "properties": {}
}