Name: Domain Authority Pagerank
Brand: quickpod
SKU: api-quickpod-aiquick-pagerank
Availability: InStock
Author: API Market

Anil Singh

# Domain Authority Pagerank

## Overview

The Domain Authority Pagerank API provides production-grade domain authority and pagerank-style metrics, offering a quick signal for SEO analysis, competitive research, and domain ranking workflows. It allows developers and analysts to look up comprehensive authority metrics for any domain name or host in real-time. By simply sending a domain string, you receive a detailed response indicating whether a match was found in the source data, the original query, and a result object containing a wealth of scoring fields.

This API is ideal for enriching lists of domains, prioritizing outreach, building backlink reports, or comparing site authority across various market segments. Its straightforward response structure is designed for easy consumption in downstream automation, enabling efficient integration into existing scoring or reporting logic.

## Features

- **Domain and Host Authority Lookup:** Get authority metrics for any specified domain or host.
- **PageRank Position & Value:** Access `pr_pos` (position) and `pr_val` (value) metrics for comprehensive PageRank insights.
- **10-Point Authority Scoring:** Utilize `pr_score_10` and `pr_score_10_bucket` fields for an easily consumable 10-point scale authority score.
- **Harmonic Value & Authority Weight:** Benefit from advanced `harmonic_val` and `authority_weight` metrics for deeper analysis.
- **Canonical Domain Identification:** Returned results include the canonical domain for precise analysis.
- **Real-time Data Access:** Access up-to-date authority metrics for immediate decision-making.

## Use Cases

The Domain Authority Pagerank API is a powerful tool for a variety of SEO and marketing professionals:

1.  **SEO Audit & Strategy Development:** Quickly assess the authority of domains during SEO audits to identify strengths, weaknesses, and opportunities for improvement. Inform strategic decisions on content creation, link building, and technical SEO prioritization.
2.  **Backlink & Outreach Prioritization:** Enrich lists of potential outreach targets with authority metrics to prioritize domains with higher impact. This helps SEO teams focus their efforts on securing backlinks from more authoritative and valuable sources.
3.  **Competitive Analysis:** Compare the domain authority and PageRank metrics of competitors' websites against your own or across an industry segment. Identify market leaders, uncover their link-building strategies, and benchmark performance.
4.  **Domain Acquisition & Valuation:** When evaluating potential domain acquisitions or portfolio management, use authority metrics to gauge the intrinsic value and potential SEO benefits of a domain before investment.
5.  **Content Strategy & Planning:** Inform content strategy by identifying high-authority domains that rank for target keywords. Understanding the competitive landscape in terms of authority can guide decisions on content depth, promotion, and potential partnerships.

## Pricing

Pricing for the Domain Authority Pagerank API is based on usage volume.
- 1 API unit equals 1 domain lookup.
- Different pricing tiers are available based on usage volume, offering cost-effective solutions for various scales of operations.

## API Documentation

### Base URL

All API requests should be made to:
`https://prod.api.market/api/v1/quickpod/aiquick-pagerank`

### Authentication

Authentication is handled via API key. Include your API key in the request header:
```
x-api-market-key: YOUR_API_MARKET_KEY
```

### Endpoints

#### 1. Service health

Retrieves the health status of the API service.

- **Endpoint:** `GET /api/v1/quickpod/aiquick-pagerank/health`
- **Description:** Checks if the underlying service is operational.
- **Tags:** `Health`

**Request Example (cURL):**
```bash
curl -X GET "https://prod.api.market/api/v1/quickpod/aiquick-pagerank/health" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Response Example (200 OK):**
```json
{
  "ok": true
}
```

#### 2. Pagerank dataset health

Retrieves the health status of the Pagerank dataset.

- **Endpoint:** `GET /api/v1/quickpod/aiquick-pagerank/kdb/health`
- **Description:** Provides information on the availability and status of the Pagerank dataset.
- **Tags:** `Health`

**Request Example (cURL):**
```bash
curl -X GET "https://prod.api.market/api/v1/quickpod/aiquick-pagerank/kdb/health" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Response Example (200 OK - Dataset Available):**
```json
{
  "status": "available",
  "duckdb_path": "/var/data/pagerank.duckdb",
  "table": "domain_authority",
  "error": null
}
```

**Response Example (200 OK - Dataset Unavailable):**
```json
{
  "status": "unavailable",
  "duckdb_path": null,
  "table": null,
  "error": "Dataset file not found or inaccessible."
}
```

#### 3. Lookup domain authority metrics

Retrieves domain authority and pagerank-style metrics for a specified domain or host.

- **Endpoint:** `GET /api/v1/quickpod/aiquick-pagerank/kdb/domain-authority`
- **Description:** Returns pagerank/domain-authority metrics for the input domain or host.
- **Tags:** `Pagerank`

**Parameters:**
| Name    | Type   | In    | Required | Description                     | Example       |
| :------ | :----- | :---- | :------- | :------------------------------ | :------------ |
| `domain`| `string` | query | Yes      | The domain or host to look up. | `example.com` |

**Request Example (cURL):**
```bash
curl -X GET "https://prod.api.market/api/v1/quickpod/aiquick-pagerank/kdb/domain-authority?domain=example.com" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Response Example (200 OK - Domain Found):**
```json
{
  "query": "example.com",
  "found": true,
  "result": {
    "entity_type": "domain",
    "entity": "example.com",
    "domain": "example.com",
    "host": null,
    "source_graph": "aiquick-data",
    "pr_pos": 1234567,
    "pr_val": 0.0000000123,
    "pr_score_10": 7.5,
    "pr_score_10_bucket": 8,
    "harmonic_val": 0.000000005,
    "authority_weight": 0.85
  }
}
```

**Response Example (200 OK - Domain Not Found):**
```json
{
  "query": "nonexistent-domain-123.com",
  "found": false,
  "result": null
}
```

## Status Codes

A comprehensive list of HTTP status codes and their meanings in the context of this API:

- **200 OK:** The request was successful, and the server has returned the requested data. For domain lookups, this includes both found and not-found results.
- **400 Bad Request:** The request was malformed or contained invalid parameters (e.g., missing required `domain` query parameter). Review your request body and parameters.
- **401 Unauthorized:** Your API key is either missing or invalid. Ensure you are sending a valid `x-api-market-key` header with your request.
- **403 Forbidden:** Your API key is valid, but you do not have the necessary permissions to access this resource or perform this action. Contact support if you believe this is an error.
- **404 Not Found:** The requested resource could not be found. This typically indicates an incorrect API endpoint path.
- **429 Too Many Requests:** You have sent too many requests in a given amount of time ("rate limiting"). You should slow down your request rate and implement an exponential backoff retry strategy.
- **500 Internal Server Error:** A generic error message, indicating an unexpected condition was encountered on the server. This typically signifies a problem on the API provider's side.
- **503 Service Unavailable:** The server is currently unable to handle the request due to temporary overload or scheduled maintenance. You should retry the request after a short delay, potentially with exponential backoff.

## Rate Limits

To ensure fair usage and optimal performance for all users, rate limits are enforced on API requests. If you exceed the allocated request rate, you will receive a `429 Too Many Requests` HTTP status code.

We recommend implementing an exponential backoff strategy for handling `429` responses. This involves waiting a short period before retrying the request, and increasing the wait time with each subsequent failed retry. This prevents overwhelming the server and allows your application to recover gracefully.

## Error Handling

Effective error handling is crucial for building robust applications with the Domain Authority Pagerank API.

- **Interpreting Error Responses:** When an error occurs (e.g., 4xx or 5xx status codes), the API will typically return a JSON response containing an `error` object or a `detail` field with more information.

- **Common Errors and Resolution:**
  - **401 Unauthorized:** Always verify your `x-api-market-key` header. Double-check for typos or accidental omissions.
    - **400 Bad Request:** Carefully examine the error message in the response body. It will usually indicate which parameter is missing or malformed. Ensure your `domain` query parameter is present and correctly formatted.
    - **503 Service Unavailable:** This is often a transient error. Implement retry logic with exponential backoff.

- **Recommended Retry Strategies:**
  For transient errors (like `503 Service Unavailable` or `429 Too Many Requests`), implement an exponential backoff strategy:
    1.  Wait a base time (e.g., 1 second).
    2.  Retry the request.
    3.  If it fails again, double the wait time (e.g., 2 seconds, then 4 seconds, etc.).
    4.  Implement a maximum number of retries or a total timeout to prevent indefinite loops.

**Error Response Example (400 Bad Request):**
```json
{
  "detail": "Query parameter 'domain' is required."
}
```

**Error Response Example (401 Unauthorized):**
```json
{
  "detail": "Invalid or missing proxy secret"
}
```

**Error Response Example (503 Service Unavailable):**
```json
{
  "detail": "Dataset unavailable on backend"
}
```

## FAQ

**What is "Domain Authority Pagerank"?**

It's an API that provides metrics similar to traditional domain authority and PageRank, allowing you to assess the strength and influence of a domain or host.

**What kind of domains can I look up?**

You can look up any valid domain name or host string.

**What happens if a domain is not found?**

If a domain is not found in the source data, the API will return a `found: false` field in the response, and the `result` object will be `null`.

**How fresh is the data?**

The API aims to provide up-to-date metrics. Specific data refresh cycles are managed internally to ensure relevance.

**Is there a free tier or trial?**

Please refer to the API.market platform for current pricing and trial offerings.

**Can I use this API for bulk processing?**

Yes, you can use the API for bulk processing by iterating through your list of domains. Remember to respect rate limits and implement retry logic for robust processing.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.

Look up production-grade domain authority and PageRank-style metrics for any domain or host, for SEO analysis, competitive research and reporting.

Domain Authority Pagerank