# Majestic Configuration

https://api-docs.lumar.io/docs/graphql/majestic-connection

The following guide shows you how to manage the Majestic backlink data configuration for your Lumar projects. Majestic integration enriches your crawl data with external backlink metrics.

## Creating a Majestic configuration

Enable Majestic integration for a project:

```graphql
mutation CreateMajesticConfiguration($input: CreateMajesticConfigurationInput!) {
  createMajesticConfiguration(input: $input) {
    majesticConfiguration {
      enabled
      maxRows
      useHistoricData
      useRootDomain
    }
  }
}
```

**Variables:**
```json
{
  "input": {
    "projectId": "TjAwN1Byb2plY3Q2MTMy",
    "enabled": true,
    "maxRows": 1000,
    "useHistoricData": false,
    "useRootDomain": false
  }
}
```

**Response:**
```json
{
  "data": {
    "createMajesticConfiguration": {
      "majesticConfiguration": {
        "enabled": true,
        "maxRows": 1000,
        "useHistoricData": false,
        "useRootDomain": false
      }
    }
  }
}
```

Key configuration fields:

| Field             | Description                                                                                       |
| ----------------- | ------------------------------------------------------------------------------------------------- |
| `enabled`         | Whether Majestic data collection is active.                                                       |
| `maxRows`         | Maximum number of backlink rows to import.                                                        |
| `useHistoricData` | When `true`, uses Majestic's Historic Index (larger dataset). When `false`, uses the Fresh Index. |
| `useRootDomain`   | When `true`, queries backlinks for the root domain. When `false`, queries the specific subdomain. |

## Querying the configuration

Retrieve the current Majestic configuration for a project:

```graphql
query GetMajesticConfiguration($projectId: ObjectID!) {
  getProject(id: $projectId) {
    majesticConfiguration {
      enabled
      maxRows
      useHistoricData
      useRootDomain
      createdAt
    }
  }
}
```

**Variables:**
```json
{
  "projectId": "TjAwN1Byb2plY3Q2MTMy"
}
```

**Response:**
```json
{
  "data": {
    "getProject": {
      "majesticConfiguration": {
        "enabled": true,
        "maxRows": 1000,
        "useHistoricData": false,
        "useRootDomain": false,
        "createdAt": "2025-01-10T08:00:00.000Z"
      }
    }
  }
}
```

## Updating the configuration

Modify the Majestic configuration:

```graphql
mutation UpdateMajesticConfiguration($input: UpdateMajesticConfigurationInput!) {
  updateMajesticConfiguration(input: $input) {
    majesticConfiguration {
      enabled
      maxRows
      useHistoricData
      useRootDomain
    }
  }
}
```

**Variables:**
```json
{
  "input": {
    "projectId": "TjAwN1Byb2plY3Q2MTMy",
    "enabled": true,
    "maxRows": 5000,
    "useHistoricData": true
  }
}
```

**Response:**
```json
{
  "data": {
    "updateMajesticConfiguration": {
      "majesticConfiguration": {
        "enabled": true,
        "maxRows": 5000,
        "useHistoricData": true,
        "useRootDomain": false
      }
    }
  }
}
```

All fields in the update input are optional -- only include the fields you want to change.