Namecheap APInamecheap.com ↗
Search domain availability, get TLD pricing, browse marketplace auctions, and fetch hosting bundles from Namecheap via a structured JSON API.
What is the Namecheap API?
The Namecheap API covers 5 endpoints that expose domain availability, TLD registration and renewal pricing, marketplace auction listings, and hosting bundle data from Namecheap.com. The list_tld_prices endpoint alone returns pricing objects for every supported generic and country-code TLD, including registration, renewal, and promotional hint fields. Additional endpoints let you search active auctions by keyword, check specific domain statuses, and retrieve curated marketplace collections.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/145d80b0-7c17-4ae9-adc6-1bc6a9c8a42a/list_tld_prices' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace namecheap-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Namecheap domain marketplace: browse TLD pricing, search auctions, check status."""
from parse_apis.namecheap_api import Namecheap, AuctionSort, HostingPlan, DomainInputError
client = Namecheap()
# List TLD pricing — get the full catalog in one call.
for tld in client.tlds.list(limit=5):
print(tld.name, tld.type, tld.pricing.price, tld.pricing.renewal)
# Search marketplace auctions sorted by price ascending.
auction = client.auctions.search(keyword="tech", sort=AuctionSort.PRICE_ASC, limit=1).first()
if auction:
print(auction.name, auction.tld, auction.price, auction.bid_count, auction.end_date)
# Check marketplace status for specific domains.
for ds in client.domainstatuses.check(domains="example.com,test.ai", limit=5):
print(ds.domain, ds.status)
# Browse hosting bundles — each bundle pairs a plan with a free domain.
for bundle in client.hostingbundles.list(product=HostingPlan.STELLAR_PLUS, limit=3):
print(bundle.bundle_id, bundle.products[0].name, bundle.products[0].bundle_price)
# Typed error handling around domain status check.
try:
for ds in client.domainstatuses.check(domains="bad-input", limit=1):
print(ds.domain, ds.status)
except DomainInputError as exc:
print(f"Input error: {exc}")
print("exercised: tlds.list / auctions.search / domainstatuses.check / hostingbundles.list")
Get comprehensive pricing for all TLDs (generic and country-code), including registration, renewal, and promotional hints. Returns an array of TLD objects with pricing details. Each TLD includes its type (GTLD or CCTLD), categories, and year limits for registration.
No input parameters required.
{
"type": "object",
"fields": {
"tlds": "array of TLD pricing objects with Name, Type, Pricing, Categories, and registration year limits"
},
"sample": {
"data": {
"tlds": [
{
"IDN": false,
"Name": "ac",
"Type": "CCTLD",
"Pricing": {
"Hint": "54% off 1st year",
"Price": 28.98,
"Regular": 62.98,
"Renewal": 76.98,
"Tooltip": "",
"Duration": 1,
"DurationType": "YEAR",
"AdditionalCost": null,
"AdditionalHint": null,
"RegularAdditionalCost": null
},
"TldsState": "",
"Categories": [
{
"CategoryName": "new",
"SeqNoOfProduct": 170
}
],
"NonRealtime": false,
"ContactEditable": true,
"MaxRegisterYears": 10,
"MinRegisterYears": 1,
"WhoisguardCompatibile": false
}
]
},
"status": "success"
}
}About the Namecheap API
Domain Search and TLD Pricing
The list_tld_prices endpoint returns an array of TLD pricing objects, each with Name, Type (GTLD or CCTLD), and a Pricing block containing Price, Regular, Renewal, and Hint fields. The Categories field groups each TLD by theme (e.g. business, technology, country). No query parameters are required — the response covers the full TLD catalog in a single call, making it straightforward to build price-comparison tools or populate a domain search interface with current registration costs.
Marketplace Auctions
The search_market_auctions endpoint returns paginated auction listings with fields including name, tld, price, minBid, bidCount, endDate, saleType, status, and domain valuation signals such as estibotValue and goDaddyValue. You can filter results with the keyword parameter, control sort order using ending_soon, price_asc, or price_desc, and control page size with limit. The get_market_home endpoint complements this by returning themed collection objects — heading, slug, and top auction items — from the marketplace homepage, useful for surfacing curated picks like Closeouts or AI-themed domains.
Domain Status and Hosting Bundles
The check_domain_status endpoint accepts a comma-separated domains parameter and returns a status object for each domain, including a status field (e.g. active, notfound) that indicates marketplace availability. This is distinct from a registrar availability check — it reflects listing status within the Namecheap marketplace. The get_hosting_bundles endpoint accepts an optional product parameter (stellar, stellar-plus, or stellar-business) and returns BundleId and BundleProducts arrays with Name, Type (hosting or domains), BundlePrice, and regular pricing for each component in the bundle.
The Namecheap API is a managed, monitored endpoint for namecheap.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when namecheap.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official namecheap.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a TLD price-comparison table using registration and renewal fields from
list_tld_prices. - Monitor expiring domain auctions by polling
search_market_auctionssorted byending_soon. - Find undervalued auction domains by comparing
priceagainstestibotValueorgoDaddyValue. - Check whether a specific set of domains is actively listed for sale using
check_domain_status. - Surface themed domain collections (AI, Closeouts) on a landing page using
get_market_home. - Compare hosting plan pricing and bundled domain costs across Stellar tiers using
get_hosting_bundles. - Aggregate CCTLD vs GTLD pricing for a country-specific domain marketplace or registrar comparison tool.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Namecheap have an official developer API?+
What does `check_domain_status` return, and how is it different from a standard WHOIS check?+
status within the Namecheap marketplace — values like active or notfound — indicating whether the domain is listed for sale there. It does not return WHOIS registration data, expiry dates, or registrant details. You can fork the API on Parse and revise it to add a WHOIS-style endpoint if that data is available from another source.Does the API return bidding history or individual bid records for auctions?+
search_market_auctions endpoint returns aggregate auction data including bidCount, price, minBid, and endDate, but not a per-bid history or bidder identities. You can fork the API on Parse and revise it to add a bid-history endpoint if that data is needed.Are results from `search_market_auctions` paginated, and what controls are available?+
page (page number), limit (items per page), keyword (text filter on domain names), and sort (ending_soon, price_asc, or price_desc). Combine page and limit to walk through large result sets. The keyword filter applies to domain names, not TLD category or other metadata fields.Does the API cover domain backorder or drop-catching listings?+
search_market_auctions, curated homepage collections via get_market_home, and domain status checks. Backorder or drop-catch inventory is not exposed in the current endpoints. You can fork the API on Parse and revise it to add coverage for those listing types.