Backlinq
Documentation

Backlinq API Documentation

Four GET endpoints. Predictable JSON responses. Everything you need to add backlink data to your application.

Get API keySupport
Quick Start

First request in 3 minutes

1

Get your API key

Sign up for a free account and copy your API key from the dashboard.

Sign up free
2

Make your first request

Pass your API key in the X-API-Key header to fetch data for any domain.

3

Build with real data

Wire backlink intelligence into your app, reporting tool, or workflow.

Authentication

API key authentication

Every request requires your API key passed in the X-API-Key header. Grab your key from the dashboard after signing up.

Keep your key private

Never put your API key in frontend code or public repositories. Store it in an environment variable on your server.

Header
X-API-Key: <your-api-key>
API Reference

Four endpoints. All the data.

Domain Authority

GET/domain-authority

Returns the Domain Authority score, PageRank, Global Rank, and Spam Score for any domain.

Parameters

domain(string)required
The domain to analyze (e.g., example.com)
const res = await fetch(
  "https://api.backlinq.dev/v1/domain-authority?domain=github.com",
  { headers: { "X-API-Key": "<your-key>" }}
);
const data = await res.json();
console.log(data);
Example Response
{
  "domain": "github.com",
  "pageRank": 9,
  "rank": "1",
  "domainAuthority": 92,
  "spamScore": 1,
  "linksIn": 4821032
}

Backlink Profile

GET/backlinks

Returns the total backlink count, referring domain count, and the top linking URLs for a domain.

Parameters

domain(string)required
The domain to analyze (e.g., example.com)
limit(number)
Number of top links to return. Default: 20, max: 100
const res = await fetch(
  "https://api.backlinq.dev/v1/backlinks?domain=github.com&limit=20",
  { headers: { "X-API-Key": "<your-key>" }}
);
const data = await res.json();
console.log(data);
Example Response
{
  "domain": "github.com",
  "pageRank": 9,
  "rank": "1",
  "domainAuthority": "not fetched — use domain-authority endpoint",
  "totalBacklinks": 8432109,
  "referringDomainsCount": 142876,
  "topBacklinks": [
    {
      "url": "https://stackoverflow.com/q/2003505",
      "timestamp": "2024-11-15T08:32:00Z",
      "status": "200",
      "source": "moz"
    }
  ]
}

Referring Domains

GET/referring-domains

Returns a deduplicated list of external domains that link to the target domain.

Parameters

domain(string)required
The domain to analyze (e.g., example.com)
limit(number)
Number of domains to return. Default: 20, max: 100
const res = await fetch(
  "https://api.backlinq.dev/v1/referring-domains?domain=github.com&limit=50",
  { headers: { "X-API-Key": "<your-key>" }}
);
const data = await res.json();
console.log(data);
Example Response
{
  "domain": "github.com",
  "totalFound": 2,
  "referringDomains": [
    {
      "domain": "stackoverflow.com",
      "exampleUrl": "https://stackoverflow.com/q/2003505",
      "lastSeen": "2024-11-20T14:22:00Z",
      "source": "moz",
      "backlinkCount": 1842,
      "dofollowCount": 1614
    }
  ]
}

Compare Domains

GET/compare

Compares 2 to 5 domains side by side, ranked by Domain Authority.

Parameters

domains(string)required
Comma separated list of domains (e.g., "example-1.com,example-2.com")
const res = await fetch(
  "https://api.backlinq.dev/v1/compare?domains=github.com,gitlab.com,bitbucket.org",
  { headers: { "X-API-Key": "<your-key>" }}
);
const data = await res.json();
console.log(data);
Example Response
{
  "domains": ["github.com", "gitlab.com", "bitbucket.org"],
  "leaderboard": [
    { "rank": 1, "domain": "github.com", "pageRank": 9, "domainAuthority": 92, "spamScore": 1 },
    { "rank": 2, "domain": "gitlab.com", "pageRank": 8, "domainAuthority": 84, "spamScore": 2 },
    { "rank": 3, "domain": "bitbucket.org", "pageRank": 7, "domainAuthority": 79, "spamScore": 3 }
  ]
}
Error Handling

Status codes and errors

400Bad Request

Invalid parameters or missing required fields.

401Unauthorized

Invalid or missing API key.

429Rate Limited

Quota exceeded. Upgrade your plan or wait for the reset.

500Server Error

Something went wrong on our end. Try again shortly.

Error Response Format

{
  "error": true,
  "code": "RATE_LIMIT_EXCEEDED",
  "message": "Request quota exceeded. Upgrade your plan at /dashboard/billing"
}
Rate Limits

Plan quotas and limits

Free$0
Requests30/mo
Overage—
Pro$49/mo
Requests500/mo
Overage$0.10/request
Scale$129/mo
Requests2,500/mo
Overage$0.10/request

Note: Quotas reset at the start of each billing cycle. Free tier accounts are cut off at 30 requests with no overage. Paid plans continue past their quota at $0.10 per additional request.

SDKs

Official SDKs

The REST API is ready today. Native SDK packages are on the roadmap for the languages below.

JavaScript/TypeScript

Coming Soon

Python

Coming Soon

Go

Coming Soon

Ruby

Coming Soon

PHP

Coming Soon

Rust

Coming Soon

Ready to start building?

Get your API key and make your first request in minutes. No credit card required.

Get started free