API Documentation
Last updated: April 12, 2026
The NewSiteLead API provides programmatic access to our domain intelligence database. API access is available on Pro and Enterprise plans.
Authentication
All API requests require an API key passed as a query parameter:
GET https://newsitelead.com/api/v1/domains?api_key=YOUR_API_KEYGenerate and manage your API keys from the API tab in your dashboard. API keys are stored as SHA-256 hashes — we cannot retrieve a lost key. If you lose your key, revoke it and create a new one.
Endpoints
GET /api/v1/domains
Search and filter the domain database.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
api_key | string (required) | Your API key |
q | string | Search query — matches domain names, page titles, and industry tags |
tld | string | Filter by TLD (e.g., com, io, net) |
page | integer | Page number (default: 1) |
per_page | integer | Results per page, 1–100 (default: 25) |
Response
[
{
"domain": "example.com",
"tld": "com",
"source": "whoisds",
"first_seen_at": "2026-04-10T00:00:00",
"status": "active",
"page_title": "Example — Cloud Hosting Platform",
"meta_description": "Fast, reliable cloud hosting for startups.",
"https_available": true,
"is_parked": false,
"country": "US",
"industry_tags": ["technology", "hosting"]
}
]Rate Limits
| Plan | Requests / minute | Max per_page |
|---|---|---|
| Pro ($79/mo) | 60 | 100 |
| Enterprise ($199/mo) | 120 | 100 |
If you exceed the rate limit, the API returns 429 Too Many Requests. Back off and retry after 60 seconds.
Usage Terms
- Internal use only: API data may be used for your internal business purposes — lead generation, market research, competitive analysis, CRM enrichment
- No redistribution: You may not resell API data, redistribute it as a standalone dataset, or use it to build a competing domain intelligence service
- Local caching: You may cache API responses locally for reasonable operational purposes (e.g., avoiding redundant calls). Cached data must not be shared externally
- Key security: API keys must not be embedded in client-side code, public repositories, or shared with unauthorized parties. Compromised keys should be revoked immediately
- Compliance: You are responsible for ensuring your use of API data complies with all applicable laws, including CAN-SPAM, GDPR, and CASL if used for outreach
Service Level
- Availability target: We target 99.5% monthly uptime for the API. This is a goal, not a contractual SLA with financial credits
- Maintenance windows: Planned maintenance is performed during off-peak hours (typically weekday nights, Pacific Time) with advance notice when possible
- Support: Pro plan customers receive email support. Enterprise customers receive priority email support with a target 4-hour response time during business hours (Mon–Fri, 9am–5pm PT)
Error Codes
| Code | Meaning |
|---|---|
401 | Missing or invalid API key |
403 | API access not available on your plan (upgrade to Pro or Enterprise) |
429 | Rate limit exceeded — wait 60 seconds and retry |
500 | Internal server error — retry with exponential backoff |
Questions?
For API support or questions, contact contact@newsitelead.com.