Sav

Domain API

Programmatic access to domain search, registration, DNS, and auctions.

Authentication

All authenticated endpoints require a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Generate API keys from your Account Settings.

Base URL:https://bigfame.ai

Endpoints

GET/api/domains/search?query={domain}

Search for available domains by keyword or exact match.

curl "https://bigfame.ai/api/domains/search?query=example"
POST/api/domains/purchase

Register/purchase an available domain.

curl -X POST https://bigfame.ai/api/domains/purchase \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{"domain":"example.com","years":1}'
GET/api/domains/manage

List all domains in your account.

curl -H "Authorization: Bearer YOUR_KEY" \
  https://bigfame.ai/api/domains/manage
GET/api/domains/dns?domain={domain}

Get DNS records for a domain.

curl -H "Authorization: Bearer YOUR_KEY" \
  "https://bigfame.ai/api/domains/dns?domain=example.com"
PUT/api/domains/dns

Update DNS records for a domain.

curl -X PUT https://bigfame.ai/api/domains/dns \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{"domain":"example.com","records":[{"type":"A","name":"@","value":"1.2.3.4"}]}'
GET/api/domains/auctions

List active domain auctions with optional search/sort/filter.

curl "https://bigfame.ai/api/domains/auctions?sort=ending_soon&tld=.com"
POST/api/domains/auctions

Create a new domain auction listing.

curl -X POST https://bigfame.ai/api/domains/auctions \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{"domain":"premium.com","startingPrice":100,"durationDays":7}'
POST/api/domains/auctions/{id}/bid

Place a bid on an auction.

curl -X POST https://bigfame.ai/api/domains/auctions/abc123/bid \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{"amount":500,"bidderId":"user123"}'

Rate Limits

API requests are limited to 100 requests/minute per API key. Search endpoints are limited to 30 requests/minute. Exceeding these limits returns a 429 status code.