API documentation

The estimate model is published on Replicate and can be called directly. Up to 2,560 domains per request. HumbleWorth adds no limit of its own; Replicate's account limits and pricing apply.

Model
humbleworth/price-predict-v1
Version
a925db842c70…
Runtime
CPU · typically <2s
On this page
  1. 01 Overview
  2. 02 Authentication
  3. 03 Quick start
  4. 04 JavaScript
  5. 05 Python
  6. 06 Input
  7. 07 Response
  8. 08 Limits and pricing
  9. 09 Model notes

Overview

The model combines domain embeddings with word embeddings using Sentence Transformers to predict a value per sale channel. It is hosted on Replicate at humbleworth/price-predict-v1, so billing, scaling, and client libraries are all Replicate's.

Authentication

Requests authenticate with a Replicate API token. Create one at replicate.com/account/api-tokens and expose it to your process:

Terminal 
export REPLICATE_API_TOKEN=r8_your_token_here

Quick start

Scaffold a working project with Replicate's generator:

Terminal 
npx create-replicate --model=humbleworth/price-predict-v1

JavaScript

Terminal 
npm install replicate
JavaScript 
import Replicate from "replicate";

const replicate = new Replicate({
  auth: process.env.REPLICATE_API_TOKEN,
});

const output = await replicate.run(
  "humbleworth/price-predict-v1:a925db842c707850e4ca7b7e86b217692b0353a9ca05eb028802c4a85db93843",
  {
    input: {
      domains: "example.com, startup.net, innovation.org"
    }
  }
);

console.log(output);

Python

Terminal 
pip install replicate
Python 
import replicate

output = replicate.run(
    "humbleworth/price-predict-v1:a925db842c707850e4ca7b7e86b217692b0353a9ca05eb028802c4a85db93843",
    input={
        "domains": "example.com, startup.net, innovation.org"
    }
)

print(output)

Input

FieldTypeDescription
domainsstringComma-separated domain names, up to 2,560 per request. Include the TLD on each name.
Example request 
{
  "domains": "CoatFinder.com, CommissionWell.com, tech.net"
}

Input rules

  • Lowercase is normalised for you, but submitting lowercase is more predictable.
  • Batch aggressively. One 2,560-domain call is far cheaper than 2,560 calls.
  • Internationalised domain names and special characters are not supported.

Response

The response is a JSON object with a valuations array, one entry per input domain, in request order.

FieldTypeMeaning
domainstringThe normalised domain name.
auctionnumberUSD estimate in a competitive auction (50th percentile).
marketplacenumberUSD estimate for a direct marketplace sale (97.5th percentile).
brokeragenumberUSD estimate through a broker-assisted sale (99.25th percentile).
Example response 
{
  "valuations": [
    {
      "domain": "coatfinder.com",
      "auction": 35,
      "marketplace": 2616,
      "brokerage": 7871
    },
    {
      "domain": "commissionwell.com",
      "auction": 30,
      "marketplace": 3017,
      "brokerage": 9370
    }
  ]
}

Limits and pricing

Price$0.10 per 1,000 predictions
Batch sizeUp to 2,560 domains per request
LatencyTypically under 2 seconds
Rate limitNone beyond Replicate's account limits

Billing runs through Replicate. See the model page for current pricing and to run it in the browser.

Model notes

Worth knowing before you build on these numbers:

  • Estimates are model output, not appraisals, and should not be the sole basis for a purchase.
  • Training data extends through early 2024, so very recent market movement is not represented.
  • The model is optimised for English-language names.
  • Trademark exposure and legal risk are not evaluated.

The methodology page covers the data sources and the wider set of limitations. Questions go to hello@humbleworth.com.