Majestic Configuration

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:

Mutation

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

Variables

{
  "input": {
    "projectId": "TjAwN1Byb2plY3Q2MTMy",
    "enabled": true,
    "maxRows": 1000,
    "useHistoricData": false,
    "useRootDomain": false
  }
}

Response

{
  "data": {
    "createMajesticConfiguration": {
      "majesticConfiguration": {
        "enabled": true,
        "maxRows": 1000,
        "useHistoricData": false,
        "useRootDomain": false
      }
    }
  }
}

cURL

curl -X POST -H "Content-Type: application/json" -H "apollographql-client-name: docs-example-client" -H "apollographql-client-version: 1.0.0" -H "x-auth-token: YOUR_API_SESSION_TOKEN" --data '{"query":"mutation CreateMajesticConfiguration($input: CreateMajesticConfigurationInput!) { createMajesticConfiguration(input: $input) { majesticConfiguration { enabled maxRows useHistoricData useRootDomain } } }","variables":{"input":{"projectId":"TjAwN1Byb2plY3Q2MTMy","enabled":true,"maxRows":1000,"useHistoricData":false,"useRootDomain":false}}}' https://api.lumar.io/graphql

Try in explorer

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:

Query

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

Variables

{
  "projectId": "TjAwN1Byb2plY3Q2MTMy"
}

Response

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

cURL

curl -X POST -H "Content-Type: application/json" -H "apollographql-client-name: docs-example-client" -H "apollographql-client-version: 1.0.0" -H "x-auth-token: YOUR_API_SESSION_TOKEN" --data '{"query":"query GetMajesticConfiguration($projectId: ObjectID!) { getProject(id: $projectId) { majesticConfiguration { enabled maxRows useHistoricData useRootDomain createdAt } } }","variables":{"projectId":"TjAwN1Byb2plY3Q2MTMy"}}' https://api.lumar.io/graphql

Try in explorer

Updating the configuration

Modify the Majestic configuration:

Mutation

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

Variables

{
  "input": {
    "projectId": "TjAwN1Byb2plY3Q2MTMy",
    "enabled": true,
    "maxRows": 5000,
    "useHistoricData": true
  }
}

Response

{
  "data": {
    "updateMajesticConfiguration": {
      "majesticConfiguration": {
        "enabled": true,
        "maxRows": 5000,
        "useHistoricData": true,
        "useRootDomain": false
      }
    }
  }
}

cURL

curl -X POST -H "Content-Type: application/json" -H "apollographql-client-name: docs-example-client" -H "apollographql-client-version: 1.0.0" -H "x-auth-token: YOUR_API_SESSION_TOKEN" --data '{"query":"mutation UpdateMajesticConfiguration($input: UpdateMajesticConfigurationInput!) { updateMajesticConfiguration(input: $input) { majesticConfiguration { enabled maxRows useHistoricData useRootDomain } } }","variables":{"input":{"projectId":"TjAwN1Byb2plY3Q2MTMy","enabled":true,"maxRows":5000,"useHistoricData":true}}}' https://api.lumar.io/graphql

Try in explorer

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