GoDaddy APIgodaddy.com ↗
Search GoDaddy for similar and alternative domain names with real-time availability and pricing. One endpoint returns TLD pricing, suggestions, and availability status.
What is the GoDaddy API?
The GoDaddy Domain Search API exposes one endpoint, search_similar_domains, that returns up to 100 alternative domain name suggestions alongside live pricing and availability data. Given any domain name or keyword, it returns the queried domain's availability status, a breakdown of pricing across TLD extensions, and a ranked list of similar domain options — each with full pricing, extension, and inventory metadata.
curl -X GET 'https://api.parse.bot/scraper/f901af67-4a69-4538-bd86-1845fbfdbfb5/search_similar_domains?domain=shopify.com' \ -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 godaddy-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.
"""Walkthrough: GoDaddy domain search — find alternatives for a domain."""
from parse_apis.godaddy_com_api import GoDaddy, InputFormatInvalid
client = GoDaddy()
# Search for similar domains and pricing alternatives for a keyword.
try:
result = client.domain_searches.search(domain="coffeeshop.com", limit=5)
except InputFormatInvalid:
print("Invalid domain input")
raise
# Inspect the queried domain's availability.
queried = result.queried_domain
print(f"{queried.fqdn}: available={queried.is_available}, price={queried.price_display or 'N/A'}")
# Browse TLD pricing alternatives.
for tld in result.tld_pricing:
label = " (promo)" if tld.is_promo else ""
print(f" .{tld.tld}: {tld.current_price_display}{label}, renews at {tld.renewal_price_display}")
# List similar domain suggestions with prices.
print(f"\n{result.total_similar} similar domains found:")
for domain in result.similar_domains:
tag = "premium" if domain.is_premium else domain.inventory
print(f" {domain.fqdn} — {domain.price_display or 'TLD price'} [{tag}]")
print("\nexercised: domain_searches.search / QueriedDomain / TldPrice / SimilarDomain")
Given a domain name (e.g. 'shopify.com' or 'mybusiness'), returns the queried domain's availability status, pricing for related TLD extensions, and a list of similar/alternative domain suggestions with their prices. Similar domains include keyword variations, different TLDs, premium aftermarket domains, and auction listings. Non-premium spin domains use TLD-level pricing from the tld_pricing array. Each request makes two upstream round trips. The limit parameter controls how many similar domains are returned (max 100).
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of similar domain suggestions to return, capped at 100. |
| domainrequired | string | The domain name to find alternatives for (e.g. 'example.com', 'mystore.net', or just a keyword like 'bakery'). |
{
"type": "object",
"fields": {
"tld_pricing": "array of TLD extension pricing objects (tld, current_price, list_price, renewal_price, and display strings)",
"total_similar": "integer count of similar domains returned",
"queried_domain": "object with fqdn, is_available, is_purchasable, price, price_display, extension, and availability status of the input domain",
"similar_domains": "array of similar domain suggestions with fqdn, extension, name_without_extension, price, price_display, domain_source, inventory type, and flags"
},
"sample": {
"data": {
"tld_pricing": [
{
"tld": "com",
"is_promo": true,
"list_price": 22.99,
"current_price": 12.99,
"renewal_price": 22.99,
"list_price_display": "$22.99",
"current_price_display": "$12.99",
"renewal_price_display": "$22.99"
}
],
"total_similar": 10,
"queried_domain": {
"fqdn": "shopify.com",
"price": 0,
"extension": "com",
"availability": "taken",
"is_available": false,
"price_display": "",
"is_purchasable": false
},
"similar_domains": [
{
"fqdn": "shopify-co.com",
"price": 0,
"extension": "com",
"inventory": "spins",
"is_premium": false,
"is_available": true,
"domain_source": "keywordspin",
"price_display": "",
"name_without_extension": "shopify-co"
},
{
"fqdn": "webshopify.com",
"price": 8499,
"extension": "com",
"inventory": "premium",
"is_premium": true,
"is_available": true,
"domain_source": "premium",
"price_display": "$8,499.00",
"name_without_extension": "webshopify"
}
]
},
"status": "success"
}
}About the GoDaddy API
What the API Returns
The search_similar_domains endpoint accepts a single required parameter, domain, which can be a fully qualified domain name (e.g. shopify.com, mystore.net) or a bare keyword like bakery. The response includes three top-level structures: queried_domain, tld_pricing, and similar_domains.
The queried_domain object tells you whether the submitted domain is available and purchasable, its current price and display-formatted price string, its extension, and its full FQDN. This gives you a direct availability check on the exact domain you queried.
TLD Pricing and Similar Domain Suggestions
The tld_pricing array lists available TLD extensions for the queried name, with tld, current_price, list_price, renewal_price, and display strings for each — useful for comparing registration costs across .com, .net, .io, and other extensions at a glance.
The similar_domains array is where alternative suggestions live. Each entry carries fqdn, extension, name_without_extension, price, price_display, domain_source, and inventory type fields. The limit parameter (optional, max 100) controls how many similar domains are returned, and total_similar in the response tells you the actual count. Domain source and inventory type fields help distinguish between standard registry availability and premium or aftermarket listings.
The GoDaddy API is a managed, monitored endpoint for godaddy.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when godaddy.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 godaddy.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?+
- Check whether a target domain is available and purchasable before committing to a brand name
- Compare registration prices across TLD extensions using
tld_pricingto find the most cost-effective option - Build a domain suggestion tool that surfaces keyword-based alternatives when a preferred domain is taken
- Identify premium or aftermarket domain inventory by inspecting
domain_sourceand inventory type fields insimilar_domains - Monitor renewal pricing shifts on specific TLD extensions using
renewal_pricefrom thetld_pricingarray - Automate domain portfolio research by batch-querying keywords and collecting available alternatives with pricing
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does GoDaddy have an official developer API?+
What does `queried_domain` actually tell me versus `similar_domains`?+
queried_domain is the availability and pricing record for the exact domain you submitted — it includes is_available, is_purchasable, price, and extension. similar_domains is a separate array of alternative suggestions based on keyword variations and different TLDs, each with its own pricing and inventory metadata. The two are distinct and returned together in the same response.Can I look up historical domain pricing or track price changes over time?+
Does the API return WHOIS or ownership data for registered domains?+
Is there a way to filter similar domain suggestions by TLD or price range?+
limit parameter caps the total number of suggestions returned (up to 100), but there is no built-in filter for specific TLDs or price thresholds within the endpoint. Filtering by extension or price must be done client-side against the similar_domains array fields (extension, price).