GET /auctions

Domain Auctions

Learn more: Domain Auction API — marketing overview, live demo, and use cases.

Browse and search live domain auctions aggregated from multiple marketplaces.

Endpoint

GET https://api.robotdomainsearch.com/auctions

Parameters

Parameter	Type	Required	Default	Description
`q`	string	No		Search query — filters by domain name
`tld`	string	No		Filter by TLD (e.g., `com`, `net`)
`source`	string	No		Filter by marketplace: `namecheap`, `sedo`, `dynadot`
`min_price`	number	No		Minimum current price in USD (e.g., `10.50`)
`max_price`	number	No		Maximum current price in USD (e.g., `500`)
`min_bids`	integer	No		Minimum number of bids
`ending_within`	string	No		Time window filter: `1h`, `6h`, `24h`, `3d`, `7d`
`sort`	string	No	`ending_soon`	Sort order (see Sort Modes below)
`quality_min`	integer	No	`0`	Minimum quality score (0–100)
`hot`	boolean	No	`false`	Shortcut: sets `quality_min=60`, `min_bids=1`, `sort=quality`
`limit`	integer	No	`50`	Number of results to return
`offset`	integer	No	`0`	Offset for pagination

Sort Modes

Value	Description
`ending_soon`	Auctions ending soonest first (default)
`most_bids`	Most bids first
`price_asc`	Lowest price first
`price_desc`	Highest price first
`quality`	Highest quality score first
`newest`	Most recently listed first

Request

curl "https://api.robotdomainsearch.com/auctions?q=crypto&tld=com&sort=most_bids&limit=10"

With price filter:

curl "https://api.robotdomainsearch.com/auctions?min_price=100&max_price=5000&ending_within=24h"

Hot auctions shortcut:

curl "https://api.robotdomainsearch.com/auctions?hot=true"

Response

{
  "auctions": [
    {
      "domain": "cryptovault.com",
      "tld": "com",
      "source": "namecheap",
      "source_url": "https://www.namecheap.com/domains/auction/cryptovault.com",
      "current_price": 1250.00,
      "start_price": 25.00,
      "currency": "USD",
      "price_usd": 1250.00,
      "bid_count": 47,
      "started_at": "2026-01-28T10:00:00Z",
      "ends_at": "2026-02-08T10:00:00Z",
      "quality_score": 82,
      "metrics": {
        "ahrefs_dr": 45,
        "ahrefs_backlinks": 1230,
        "semrush_score": 38,
        "semrush_backlinks": 980,
        "majestic_cf": 28,
        "majestic_tf": 22,
        "majestic_backlinks": 750,
        "estibot_value": 8500.00,
        "go_value": 12000.00,
        "keyword_search_volume": 14800,
        "extensions_taken": 8,
        "registered_date": "2015-03-14",
        "last_sold_price": 3200.00,
        "last_sold_year": 2021,
        "renewal_price": 10.98,
        "inbound_links": 450,
        "domain_age_years": 11
      },
      "updated_at": "2026-02-07T18:30:00Z"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 50,
    "offset": 0,
    "sources": {
      "namecheap": {
        "last_sync": "2026-02-07T18:00:00Z",
        "count": 15230
      },
      "sedo": {
        "last_sync": "2026-02-07T17:45:00Z",
        "count": 8420
      },
      "dynadot": {
        "last_sync": "2026-02-07T18:10:00Z",
        "count": 3150
      }
    }
  }
}

Response Fields

Top-Level Fields

Field	Type	Description
`auctions`	array	List of auction objects
`meta`	object	Pagination and source metadata

Auction Fields

Field	Type	Description
`domain`	string	Full domain name
`tld`	string	Top-level domain
`source`	string	Marketplace: `namecheap`, `sedo`, or `dynadot`
`source_url`	string	Direct link to the auction page (omitted if unavailable)
`current_price`	number	Current bid price in original currency
`start_price`	number	Starting price (omitted if not available)
`currency`	string	Original currency code (e.g., `USD`, `EUR`)
`price_usd`	number	Price normalized to USD
`bid_count`	integer	Number of bids placed
`started_at`	string	ISO 8601 auction start time (omitted if unavailable)
`ends_at`	string	ISO 8601 auction end time
`quality_score`	integer	Computed quality score (0–100)
`metrics`	object	SEO and valuation metrics (omitted if none available)
`updated_at`	string	ISO 8601 last update time (omitted if unavailable)

Metrics Fields

All metrics fields are optional and omitted when not available.

Field	Type	Description
`ahrefs_dr`	integer	Ahrefs Domain Rating
`ahrefs_backlinks`	integer	Ahrefs backlink count
`semrush_score`	integer	Semrush authority score
`semrush_backlinks`	integer	Semrush backlink count
`majestic_cf`	integer	Majestic Citation Flow
`majestic_tf`	integer	Majestic Trust Flow
`majestic_backlinks`	integer	Majestic backlink count
`estibot_value`	number	Estibot appraisal value in USD
`go_value`	number	GoDaddy GoValue appraisal in USD
`keyword_search_volume`	integer	Monthly keyword search volume
`extensions_taken`	integer	Number of other TLD extensions registered
`registered_date`	string	Original registration date
`last_sold_price`	number	Last sale price in USD
`last_sold_year`	integer	Year of last sale
`renewal_price`	number	Annual renewal price in USD
`inbound_links`	integer	Inbound link count
`domain_age_years`	integer	Domain age in years

Meta Fields

Field	Type	Description
`total`	integer	Total number of matching auctions
`limit`	integer	Number of results returned
`offset`	integer	Current pagination offset
`sources`	object	Sync status per marketplace source

Source Sync Fields

Each source in meta.sources contains:

Field	Type	Description
`last_sync`	string	ISO 8601 time of last data sync
`count`	integer	Total active auctions from this source

Errors

Code	Error	Description
400	`invalid_parameter`	Invalid parameter value (see message for details)
405	`method_not_allowed`	Only GET method is allowed
500	`internal_error`	Failed to query auctions
503	`service_unavailable`	Auction service is not initialized

Validation Errors

The invalid_parameter error is returned for:

sort: Must be one of ending_soon, most_bids, price_asc, price_desc, quality, newest
ending_within: Must be one of 1h, 6h, 24h, 3d, 7d
source: Must be one of namecheap, sedo, dynadot
quality_min: Must be between 0 and 100

Code Examples

curl

curl "https://api.robotdomainsearch.com/auctions?q=crypto&sort=most_bids&limit=10"

Python

import requests

response = requests.get(
    "https://api.robotdomainsearch.com/auctions",
    params={
        "q": "crypto",
        "sort": "most_bids",
        "limit": 10,
    }
)
data = response.json()

print(f"Total: {data['meta']['total']} auctions")

for auction in data["auctions"]:
    metrics = auction.get("metrics", {})
    dr = metrics.get("ahrefs_dr", "N/A")
    print(
        f"{auction['domain']} — ${auction['price_usd']:.2f} "
        f"({auction['bid_count']} bids, DR: {dr}, "
        f"quality: {auction['quality_score']})"
    )

JavaScript

const params = new URLSearchParams({
  q: "crypto",
  sort: "most_bids",
  limit: "10",
});

const response = await fetch(
  `https://api.robotdomainsearch.com/auctions?${params}`
);
const data = await response.json();

console.log(`Total: ${data.meta.total} auctions`);

data.auctions.forEach(auction => {
  const dr = auction.metrics?.ahrefs_dr ?? "N/A";
  console.log(
    `${auction.domain} — $${auction.price_usd.toFixed(2)} ` +
    `(${auction.bid_count} bids, DR: ${dr}, ` +
    `quality: ${auction.quality_score})`
  );
});

Go

resp, err := http.Get("https://api.robotdomainsearch.com/auctions?q=crypto&sort=most_bids&limit=10")
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close()

var data struct {
    Auctions []struct {
        Domain       string  `json:"domain"`
        PriceUSD     float64 `json:"price_usd"`
        BidCount     int     `json:"bid_count"`
        QualityScore int     `json:"quality_score"`
        EndsAt       string  `json:"ends_at"`
        Metrics      *struct {
            AhrefsDR *int `json:"ahrefs_dr,omitempty"`
        } `json:"metrics,omitempty"`
    } `json:"auctions"`
    Meta struct {
        Total  int `json:"total"`
        Limit  int `json:"limit"`
        Offset int `json:"offset"`
    } `json:"meta"`
}

if err := json.NewDecoder(resp.Body).Decode(&data); err != nil {
    log.Fatal(err)
}

fmt.Printf("Total: %d auctions\n", data.Meta.Total)
for _, a := range data.Auctions {
    dr := "N/A"
    if a.Metrics != nil && a.Metrics.AhrefsDR != nil {
        dr = fmt.Sprintf("%d", *a.Metrics.AhrefsDR)
    }
    fmt.Printf("%s — $%.2f (%d bids, DR: %s, quality: %d)\n",
        a.Domain, a.PriceUSD, a.BidCount, dr, a.QualityScore)
}

Notes

Auction data is synced periodically from each marketplace source
Prices from non-USD sources are converted to USD (EUR→USD rate: 1.08)
The hot parameter is a convenience shortcut that sets quality_min=60, min_bids=1, and sort=quality
Quality scores are computed based on SEO metrics, bid activity, and domain characteristics
The metrics object is only included when at least one metric is available
All price parameters (min_price, max_price) are in USD

📄 Raw markdown: /docs/api/auctions.md