Basanta SEO API — Documentation
A complete reference for integrating the Basanta SEO API into your tools, workflows, and applications. Fetch domain-level and URL-level SEO authority-style metrics with a single GET request.
Overview
The Basanta SEO API provides lightweight, fast access to SEO authority-style metrics for any domain or URL. It returns a clean JSON object with three fields: domain_rating, url_rating, and ahrefs_rank.
These metrics are provided for SEO research, comparison, and workflow automation. They should not be treated as direct Google ranking factors or guaranteed ranking predictions. Not affiliated with Ahrefs, Google, Moz, or Semrush.
Base URL
https://seo.basantasapkota.comEndpoint
| Method | Path | Description |
|---|---|---|
| GET | /api/seo | Fetch SEO metrics for a domain or URL |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | The domain or URL to look up |
Example Requests
cURL
curl "https://seo.basantasapkota.com/api/seo?url=sudoapk.link"JavaScript (fetch)
const response = await fetch(
"https://seo.basantasapkota.com/api/seo?url=sudoapk.link"
);
const data = await response.json();
console.log(data);
// { domain_rating: 12, ahrefs_rank: 14402097, url_rating: 4 }Python (requests)
import requests
response = requests.get(
"https://seo.basantasapkota.com/api/seo",
params={"url": "sudoapk.link"}
)
data = response.json()
print(data)
# {'domain_rating': 12, 'ahrefs_rank': 14402097, 'url_rating': 4}n8n HTTP Request Node
Method: GET
URL: https://seo.basantasapkota.com/api/seo
Query Parameters:
url: {{ $json["domain"] }}
// Access in next node:
{{ $json["domain_rating"] }}
{{ $json["url_rating"] }}
{{ $json["ahrefs_rank"] }}Response Schema
{
"domain_rating": 12,
"ahrefs_rank": 14402097,
"url_rating": 4
}| Field | Type | Description |
|---|---|---|
| domain_rating | number | Domain-level authority-style score (0–100 scale indicator) |
| ahrefs_rank | number | Rank-style indicator — lower number suggests higher authority |
| url_rating | number | Page-level strength indicator (0–100 scale indicator) |
Error Responses
| Status | Meaning |
|---|---|
| 400 | Bad Request — missing or invalid url parameter |
| 401 | Unauthorized — missing or invalid API key (authenticated plans) |
| 429 | Too Many Requests — rate limit exceeded for your plan |
| 500 | Internal Server Error — something went wrong on our end |
Rate Limits
The API is completely free with no hard rate limits. We ask that you use it responsibly and avoid excessive automated requests. Responses are cached for performance.
Free Forever: No signup, no API keys, no monthly limits. Just make requests and get data.
Authentication
No authentication required. The API is open and free to use. Simply make HTTP requests to the endpoint.
# No API key needed - just make the request
curl "https://seo.basantasapkota.com/api/seo?url=example.com"No Setup Required: Start using the API immediately without any registration or configuration.
Best Practices
- 1.Pass clean domain names without protocol (e.g. example.com, not https://example.com) for consistent results.
- 2.Cache responses on your end to avoid redundant API calls and stay within rate limits.
- 3.Handle 429 errors gracefully — add retry logic with exponential backoff.
- 4.Do not use the API for real-time user-facing features without caching — it is optimized for background workflows.
- 5.Store your API key securely. Never expose it in client-side code or public repositories.
Common Use Cases
- →Bulk domain authority checks in n8n or Zapier
- →Backlink prospect qualification
- →Expired domain research pipelines
- →Guest post site vetting
- →SEO agency client audit reports
- →Lead scoring enrichment for CRMs
- →Domain marketplace listing enrichment
- →Programmatic SEO tool data layer
Disclaimer: These metrics are provided for SEO research, comparison, and workflow automation. They should not be treated as direct Google ranking factors or guaranteed ranking predictions. Not affiliated with Google, Ahrefs, Moz, or Semrush.