Squarespace APIdomains.squarespace.com ↗
Search Squarespace Domains for domain availability and registration prices. Returns exact matches, TLD variants, and suggestions with live pricing.
What is the Squarespace API?
The Squarespace Domains API exposes a single search_domains endpoint that returns up to 100 domain rows per query, covering the exact match plus related, sponsored, featured, premium, and recommended suggestions — each with live availability status and first-year registration price. Submit a full domain like hyphaflorals.com or a bare keyword, and the response includes per-row tld, source classification, and currency-converted pricing.
curl -X GET 'https://api.parse.bot/scraper/2eab7179-acfc-4d0e-a086-258ba9e1a851/search_domains?query=hyphaflorals.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 domains-squarespace-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: Squarespace Domains Search — find available domains with pricing."""
from parse_apis.domains_squarespace_com_api import SquarespaceDomains, InputNotFound
client = SquarespaceDomains()
# Search for domain suggestions and iterate the top available results.
for domain in client.domains.search(query="hyphaflorals", limit=5):
if domain.available:
pricing = domain.pricing
print(domain.domain, domain.tld, pricing.current_price_formatted if pricing else "no price")
# Get the full search metadata (total candidates, currency, exact match).
result = client.domain_searches.search(query="hyphaflorals.com", currency="USD")
print(f"Query: {result.query}, exact match: {result.exact_match}")
print(f"Total candidates: {result.total_candidates}, returned: {result.returned}")
# Drill into one specific suggestion from the wrapped results list.
first_available = next((d for d in (result.results or []) if d.available), None)
if first_available and first_available.pricing:
print(f"{first_available.domain}: {first_available.pricing.current_price_formatted}")
# Unsupported currency triggers InputNotFound.
try:
client.domain_searches.search(query="example", currency="XXX")
except InputNotFound as e:
print(f"Bad currency rejected: {e.message}")
print("exercised: domains.search / domain_searches.search")
Searches Squarespace Domains for the supplied name and returns the exact match plus similar domain suggestions (name variants, alternative TLDs, sponsored/featured/recommended options), each with live availability and the first-year registration price. One result row per domain; the exact match is always first, followed by related name variants, then alternative TLDs, deduplicated. Availability and pricing are looked up for every returned row (batches of 10 rows per availability check), so larger limits cost more round trips. pricing is null for unavailable domains; current_price is the price charged today and regular_price the undiscounted renewal-list price. total_candidates reports how many suggestions the site produced in total; this endpoint is a single bounded call with no further pagination. Unknown currency codes are rejected as stale_input.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of domain rows to return, clamped to 100. |
| queryrequired | string | Domain name or keyword to search, e.g. a full domain (hyphaflorals.com) or a bare name (hyphaflorals). Case-insensitive. |
| currency | string | 3-letter ISO currency code for prices. USD and EUR were confirmed; codes the site does not price return a stale_input error. |
{
"type": "object",
"fields": {
"query": "normalized (lower-cased) search term",
"results": "array of domain rows: domain, tld, source (exact_match|related|standard|sponsored|featured|premium|recommended|additional|default), available (bool or null if unknown), availability (available|unavailable|unknown), pricing (null when unavailable; else regular_price, regular_price_formatted, current_price, current_price_formatted, currency, is_premium)",
"currency": "currency code prices are quoted in",
"returned": "number of rows in results",
"domain_root": "the name portion the site extracted from the query",
"exact_match": "the exact domain the site matched to the query, or null",
"no_results_found": "true when the site reported no suggestions",
"total_candidates": "total distinct suggestions the site produced before limit was applied"
},
"sample": {
"data": {
"query": "hyphaflorals.com",
"results": [
{
"tld": "com",
"domain": "hyphaflorals.com",
"source": "exact_match",
"pricing": null,
"available": false,
"availability": "unavailable"
},
{
"tld": "com",
"domain": "hypha-floral.com",
"source": "related",
"pricing": {
"currency": "USD",
"is_premium": false,
"current_price": 10,
"regular_price": 20,
"current_price_formatted": "$10",
"regular_price_formatted": "$20"
},
"available": true,
"availability": "available"
},
{
"tld": "live",
"domain": "hyphaflorals.live",
"source": "sponsored",
"pricing": {
"currency": "USD",
"is_premium": false,
"current_price": 10,
"regular_price": 20,
"current_price_formatted": "$10",
"regular_price_formatted": "$20"
},
"available": true,
"availability": "available"
}
],
"currency": "USD",
"returned": 3,
"domain_root": "hyphaflorals",
"exact_match": "hyphaflorals.com",
"no_results_found": false,
"total_candidates": 167
},
"status": "success"
}
}About the Squarespace API
What the API Returns
The search_domains endpoint accepts a query string (a full domain name or bare keyword) and returns a structured result set. Each row in the results array contains the full domain, its tld, and a source label that classifies how the suggestion was generated — values include exact_match, related, standard, sponsored, featured, premium, recommended, additional, and default. The response also surfaces exact_match (the single domain directly matching your query, or null), domain_root (the name portion extracted from your input), and aggregate counts: returned and total_candidates.
Inputs and Filtering
The query parameter is case-insensitive and accepts either a bare name (hyphaflorals) or a full domain (hyphaflorals.com). Use the limit parameter (integer, max 100) to cap how many rows come back — useful when you only need the top few suggestions. The currency parameter takes a 3-letter ISO code; USD and EUR are confirmed to work. Passing a currency code the site does not natively price will return a stale or fallback price, so validate the currency field in the response against what you passed in.
Availability and Pricing
Every domain row carries live availability status and the first-year registration price in the requested currency. This makes the endpoint practical for comparing registration costs across TLDs in a single call. The no_results_found boolean flags queries where the site produced zero suggestions, letting you handle empty states cleanly without parsing an empty array alone.
The Squarespace API is a managed, monitored endpoint for domains.squarespace.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when domains.squarespace.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 domains.squarespace.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 specific domain is available before recommending it to a client or user
- Compare first-year registration prices across TLDs for a given brand name
- Surface premium and sponsored domain suggestions alongside standard results for a marketplace
- Build a domain availability widget that classifies results by source type (featured, recommended, etc.)
- Filter results to only
exact_matchorpremiumsource rows for a focused availability check - Aggregate domain pricing data in USD and EUR for cost-comparison tooling
| 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 Squarespace have an official developer API for domain search?+
What does the `source` field in each result row mean?+
source field classifies how each domain suggestion was generated. Possible values are exact_match (the domain directly matching your query), related, standard, sponsored, featured, premium, recommended, additional, and default. You can filter on this field to isolate, for example, only premium domains or only the exact_match row.Does the API return renewal prices or multi-year registration costs?+
What happens if I pass an unsupported currency code?+
currency parameter accepts ISO 4217 codes, but only codes the site natively prices (USD and EUR are confirmed) return accurate figures. Unsupported codes may return stale or fallback prices. Check the currency field in the response to confirm what currency prices are actually quoted in.