API Reference

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.com

Endpoint

MethodPathDescription
GET/api/seoFetch SEO metrics for a domain or URL

Query Parameters

ParameterTypeRequiredDescription
urlstringYesThe domain or URL to look up

Example Requests

cURL

shell
curl "https://seo.basantasapkota.com/api/seo?url=sudoapk.link"

JavaScript (fetch)

javascript
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)

python
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

n8n
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

json
{
  "domain_rating": 12,
  "ahrefs_rank": 14402097,
  "url_rating": 4
}
FieldTypeDescription
domain_ratingnumberDomain-level authority-style score (0–100 scale indicator)
ahrefs_ranknumberRank-style indicator — lower number suggests higher authority
url_ratingnumberPage-level strength indicator (0–100 scale indicator)

Error Responses

StatusMeaning
400Bad Request — missing or invalid url parameter
401Unauthorized — missing or invalid API key (authenticated plans)
429Too Many Requests — rate limit exceeded for your plan
500Internal 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.

shell
# 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.