Skip to content

Agency API

Search The Live EED Index From Your Own Tools

Generate labeled keys for controlled access to the same active domain inventory used by the website. Each successful API search uses one API search from the Agency account's daily allowance, even when no domains match.

1,000 API searches per day 500 rich results per page 10,000-domain text export Manticore-backed search Optional IP allowlists

Create Key

New API Key

Name keys after the app, team member, or server that will use them.

Usage

Endpoint Examples

JSON /api/v1/domain-search.php?q=cheese&pageSize=100&page=1
Plain text /api/v1/domain-search.txt.php?keyword=cheese&pageSize=1000&page=1

Use the same filter names as the Domains page, including source, provider, TLD, metric minimums, binary domain filters, and sort/dir. Add includeRegisterLinks=1 when you want registrar links for expired domains.

Authentication

Send the API key as a header. Query-string API keys are intentionally disabled.

Authorization: Bearer eed_live_... X-EED-API-Key: eed_live_... curl -H "Authorization: Bearer eed_live_..." "https://easyexpireddomains.com/api/v1/domain-search.php?q=finance&pageSize=100"

Endpoints

JSON
/api/v1/domain-search.php
Plain text
/api/v1/domain-search.txt.php returns one domain per line.
Metadata
/api/v1/meta.php publishes current limits and supported values.
OpenAPI 3.1
/api/v1/openapi.php returns the machine-readable contract.

Core Parameters

q or keyword
Search text. Exact domains such as example.com are matched directly.
pageSize or limit
JSON defaults to 100 and allows 500; text defaults to 1000 and allows 10000.
page
One-based page number within the 10,000-result search window. JSON returns hasMore, nextPage, and truncated.
source or type
all, auction, closeout (GoDaddy closeouts), bin, expiring, or expired.
provider
afternic, atom, auda, cnnic, domainlore, dropcatch, dynadot, gname, godaddy, internetnz, internetstiftelsen, namecheap, namesilo, nominet, registro-it, registry-hu, registry-trabis, sav, sedo, snapnames, spaceship, or expired-import.
tld
One or more TLDs without dots, separated by commas, for example com,net,co.uk.
sort / dir
Sort by quality, domain, source, majTF, majCF, majBL, majRD, mozDA, mozPA, ddLinksIn, ddPages, age, length, semTraffic, semRank, expires, or price. Direction is asc or desc.

Filter Parameters

Majestic
minTF, maxTF, minCF, maxCF, minBL, minRD, minTTF, ttfTopic, minMajEdu, minMajGov, minMajIPs.
Moz
minDA, maxDA, minPA, maxPA, maxSpam, minMozRank, minMozTrust.
DomDetailer
minDDLinks, minDDPages, minDDDofollow, minDDEdu, minDDGov.
Semrush
minSemTraffic, minSemRank, maxSemRank, minSemLinks, minSemKeywords.
Domain shape
minAge, maxAge, minNameLength, maxNameLength, containsLetters, containsNumbers, containsHyphen. Use yes or no for contains filters.
Market data
minPrice, maxPrice, minBids, minAuctionTraffic, minValuation, minRevenue, auctionType, auctionEnd (today or week, UTC), godaddyListingType, specialOption.
Links
includeRegisterLinks=1 adds registrar links for expired domains. registrar requires that option; supported values are published by /api/v1/meta.php.

Example Queries

/api/v1/domain-search.php?keyword=finance&source=expired&tld=com,net,co.uk&minTF=10&minRD=25&sort=length&dir=asc&pageSize=500&page=1 /api/v1/domain-search.txt.php?provider=gname&source=bin&maxPrice=250&containsHyphen=no&limit=10000

Validation, Limits, and Errors

Malformed JSON and duplicate parameters are rejected with 400. Unknown, invalid, or contradictory search parameters are rejected with 422 validation_failed; they are never silently ignored. Successful responses include X-Request-ID, short rate-limit, X-EED-Daily-*, pagination, and truncation headers. A 429 response includes Retry-After. The text endpoint returns one plain-text error line with a non-2xx status.

Requests are limited by key, Agency member, client IP, and total API capacity. Only one search may run at a time for one member, so creating more keys does not multiply load. Requests that reach the search backend also have a separate abuse-safety ceiling published by /api/v1/meta.php; backend failures count only toward that ceiling, not the successful-search allowance.

Each Agency account can run 1,000 successful API searches per UTC day. The allowance is shared by all of that member's API keys and is separate from website searching. JSON and plain-text requests each use one search per successful page, including an empty page; rejected or failed requests do not use the allowance. Read the current limit and remaining usage from API responses rather than embedding the number in a client.

Result Semantics and Links

Response sourceType is always auction, bin, expiring, or expired. The request value source=closeout is a convenient selector for GoDaddy closeout auction inventory; matching results still report sourceType=auction. Use provider.key for a stable provider identifier and provider.name for display only.

Monetary listing, valuation, and monthly parking-revenue fields are in USD. Times are UTC. Provider listing and optional registrar URLs can contain EED attribution or affiliate parameters; following one may generate commission for EED without changing the price you pay.

Support, Incidents, and Versioning

This is a server-to-server API and does not enable browser CORS. Keep keys out of browser code. For help, email support@easyexpireddomains.com with the X-Request-ID, endpoint, and UTC time, but never send an API key.

During a service incident, updates will be published on this API access page. Agency members can also report an incident through support@easyexpireddomains.com.

/api/v1/meta.php publishes the current configured limits and whether API access is enabled; it is capability metadata, not an uptime guarantee. Additive fields and provider values can be introduced within v1, so clients should tolerate unknown response fields and enum values. Breaking changes use a new major-version path, with deprecation notices published here before removal except where an urgent security issue requires faster action.

Keys

Manage API Keys

Loading API access...