Nautilinks Backlinks

Use this when the user asks what Nautilinks does, how its backlink buying service works, or how an AI agent can use it. Explains the French owned backlink network sold direct, with no reseller, how a purchase flows (prepaid balance or human Stripe checkout -> article drafted & published), the three price shelves (Plancton 5 EUR, Corail 15 EUR, Nautilus 30 EUR), and how authentication works. Call this first if you're not sure what this service does.

{
  "type": "object",
  "properties": {}
}

Use this when the user wants to find or compare websites where they can buy backlinks. Search the Nautilinks catalog by niche, language, minimum Trust Flow, maximum price per link, price shelf (Plancton 5 EUR / Corail 15 EUR / Nautilus 30 EUR), or run a free-text query. Returns domain, niche, authority metrics (TF/CF/RD/Moz DA), monthly traffic, ranked keywords, price per link and shelf for each match, plus each site's id (needed for get_site and create_order). Requires a Nautilinks API key.

{
  "type": "object",
  "properties": {
    "niche": {
      "description": "Filter by niche/thematic label (e.g. 'finance', 'sante', 'voyage').",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "language": {
      "description": "Filter by site language code (e.g. 'fr', 'en', 'de').",
      "type": "string",
      "minLength": 2,
      "maxLength": 10
    },
    "min_tf": {
      "description": "Minimum Majestic Trust Flow.",
      "type": "integer",
      "minimum": 0,
      "maximum": 100
    },
    "max_price_eur": {
      "description": "Maximum price per link, in EUR.",
      "type": "number",
      "minimum": 0
    },
    "shelf": {
      "description": "Filter by price shelf: 'Plancton' (5 EUR, entry-level sites), 'Corail' (15 EUR, established sites with a real audience and a worked link profile), or 'Nautilus' (30 EUR, the network's strongest sites by traffic, age and link profile density). Omit to search across all three shelves.",
      "type": "string",
      "enum": [
        "Plancton",
        "Corail",
        "Nautilus"
      ]
    },
    "query": {
      "description": "Free-text search across domain and niche label.",
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "limit": {
      "description": "Max results to return (default 20, max 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "offset": {
      "description": "Pagination offset (default 0). Use with the total count returned to page through results.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this after search_sites when the user needs to evaluate one backlink placement before buying. Fetch the full catalog record for a single site by id: domain, niche, authority metrics, traffic, ranked keywords, price per link, price shelf, and any other published attributes. Requires a Nautilinks API key.

{
  "type": "object",
  "properties": {
    "site_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ],
      "description": "The catalog site id, as returned by search_sites."
    }
  },
  "required": [
    "site_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List sold-once existing articles available on one catalog site. Returns article_id plus ranking queries, positions and impressions so you can choose a page, then pass that article_id to create_order with format=lien_insere. Requires a Nautilinks API key.

{
  "type": "object",
  "properties": {
    "site_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ],
      "description": "The catalog site id whose available existing articles should be listed."
    },
    "limit": {
      "description": "Maximum articles to return (default 50, max 200).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "site_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this only when the user has selected placements and wants to place a backlink order. This can spend the account's prepaid balance immediately. Place an order for 1 to 20 backlinks across catalog sites. Each item can request a new dedicated article or an existing-article insertion, 0/1/3/5 tier-2 links, and an optional project tag, alongside target URL, anchor and brief. Use list_site_articles first to obtain article_id for an insertion. The better of the optional promo and welcome offer is applied, then prepaid credit. Full credit settles immediately; partial credit is held and Stripe charges only the remainder through a payment_url that a human has to open and pay before anything is fulfilled; surface that link and the total to your user and never imply the purchase is complete. Call check_balance first if you want to know which way it will go. A card is never charged without a human completing the checkout. Requires a Nautilinks API key with the 'order' scope.

{
  "type": "object",
  "properties": {
    "items": {
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "site_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "number"
              }
            ],
            "description": "The catalog site id to place the link on (from search_sites/get_site)."
          },
          "target_url": {
            "type": "string",
            "format": "uri",
            "description": "The URL on the advertiser's own site that the backlink should point to."
          },
          "anchor_text": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "The anchor text for the link."
          },
          "anchor_type": {
            "description": "Optional anchor type hint: 'exact', 'partial', 'branded', 'generic' or 'naked'.",
            "type": "string",
            "minLength": 1,
            "maxLength": 40
          },
          "content_brief": {
            "description": "Optional brief/instructions for the article that will host the link.",
            "type": "string",
            "minLength": 1,
            "maxLength": 2000
          },
          "format": {
            "description": "Placement format. Omit or use article_unitaire for a new dedicated article; use lien_insere to insert into an existing article.",
            "type": "string",
            "enum": [
              "article_unitaire",
              "lien_insere"
            ]
          },
          "article_id": {
            "description": "Required when format=lien_insere; obtain it from list_site_articles.",
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "number"
              }
            ]
          },
          "tier2_pack_size": {
            "description": "Optional number of tier-2 links pointing to this backlink (0, 1, 3 or 5; default 0).",
            "anyOf": [
              {
                "type": "number",
                "const": 0
              },
              {
                "type": "number",
                "const": 1
              },
              {
                "type": "number",
                "const": 3
              },
              {
                "type": "number",
                "const": 5
              }
            ]
          },
          "project_id": {
            "description": "Optional AI-visibility project id owned by this account.",
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "number"
              }
            ]
          }
        },
        "required": [
          "site_id",
          "target_url",
          "anchor_text"
        ]
      },
      "description": "1 to 20 line items, one per backlink to purchase."
    },
    "promo_code": {
      "description": "Optional promotion or affiliate code. The API automatically compares it with the welcome offer and applies the better discount.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "idempotency_key": {
      "description": "Stable retry key. Reuse it after a timeout to get the same quote/session; a different body with the same key is rejected.",
      "type": "string",
      "minLength": 8,
      "maxLength": 200
    },
    "sandbox_credit_cents": {
      "description": "Sandbox keys only: simulated prepaid balance, in cents, for testing full-credit, mixed, and card-only outcomes.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "items"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the AI-visibility projects owned by this account. Use a returned project id with get_ai_visibility_plan to build order-ready backlink items.

{
  "type": "object",
  "properties": {}
}

Turn the latest uncited fan-out opportunities of one owned AI-visibility project into configured backlink items. This is read-only: it creates no cart, quote, charge or order. Review the returned items, then pass them to create_order to purchase them.

{
  "type": "object",
  "properties": {
    "project_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ],
      "description": "AI-visibility project id. The returned items can be passed directly to create_order."
    }
  },
  "required": [
    "project_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this before create_order to return the prepaid balance available to this API key. create_order applies this balance after discounts: full coverage settles immediately, partial coverage reduces the human-approved Stripe remainder. Requires a Nautilinks API key.

{
  "type": "object",
  "properties": {}
}

Use this after create_order returned a payment_url to check whether the user completed payment. Check whether the quote has been paid and get the resulting order_id once it has been converted to an order. Poll this after handing the payment_url to your user. Requires a Nautilinks API key.

{
  "type": "object",
  "properties": {
    "quote_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ],
      "description": "The quote_id returned by create_order."
    }
  },
  "required": [
    "quote_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when the user wants their Nautilinks order history or needs to find an order id. List orders placed with this API key, including overall status and totals. Use get_order_status on a specific order id for per-link detail. Requires a Nautilinks API key.

{
  "type": "object",
  "properties": {}
}

Use this when the user wants publication progress or the live URL for a specific order. Fetch the status of each backlink item as it moves through the fulfillment pipeline (to_assign -> assigned -> drafted -> in_review -> approved -> published -> verified), along with its anchor_text, target_url, and published_url once live. Requires a Nautilinks API key.

{
  "type": "object",
  "properties": {
    "order_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ],
      "description": "The order id, e.g. from list_orders or from a paid quote's get_quote_status result."
    }
  },
  "required": [
    "order_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}