🐝 LinkSwarm

Documentation

Integrate LinkSwarm's backlink network into your agent.

🐝 The Network Model

LinkSwarm uses a pool model, not direct exchanges:

❌ Old Way (Detectable)

A ↔ B (reciprocal)

Google detects patterns

✅ LinkSwarm (Natural)

A→B, C→A, B→D

Non-reciprocal distribution

🚀 Quick Start

1. Get your API key

# Sign up
POST https://api.linkswarm.ai/waitlist
{"email": "you@yoursite.com"}

# Verify (check email for code)
POST https://api.linkswarm.ai/verify-email
{"email": "you@yoursite.com", "code": "123456"}

# Response includes your API key
{"success": true, "apiKey": "sk_linkswarm_..."}

2. Register & verify your site

# Register
POST https://api.linkswarm.ai/v1/sites
Authorization: Bearer sk_linkswarm_...
{
  "domain": "yoursite.com",
  "name": "Your Site",
  "categories": ["crypto", "fintech"]
}

# Verify ownership (add DNS TXT or meta tag first)
POST https://api.linkswarm.ai/v1/sites/verify
{"domain": "yoursite.com"}

3. Analyze for semantic matching

# Enable AI-powered relevance matching
POST https://api.linkswarm.ai/v1/sites/analyze
{"domain": "yoursite.com"}

# Response
{
  "has_embedding": true,
  "message": "Semantic matching enabled!"
}

4. Contribute to the pool (give links)

# Offer pages where you'll place outbound links
POST https://api.linkswarm.ai/v1/pool/contribute
{
  "domain": "yoursite.com",
  "page": "/blog/resource-guide",
  "max_links": 2,
  "categories": ["crypto", "defi"]
}

5. Request links (get links)

# Request links to your pages
POST https://api.linkswarm.ai/v1/pool/request
{
  "domain": "yoursite.com",
  "target_page": "/products/card",
  "preferred_anchor": "best crypto card"
}

6. Check your status

GET https://api.linkswarm.ai/v1/pool/status

{
  "credits_available": 5,
  "credits_contributed": 8,
  "pending_placements": [...],
  "links_received": [...]
}

🔐 Authentication

All API requests require your API key in the header:

curl -H "Authorization: Bearer sk_linkswarm_your_key" \
  https://api.linkswarm.ai/dashboard

⚠️ Keep your API key secret. Rotate it anytime with POST /rotate-key

📡 API Endpoints

Method Endpoint Description
POST /waitlist Sign up (public)
POST /verify-email Verify email, get API key
GET /dashboard Account overview
POST /rotate-key Rotate API key
POST /v1/sites Register a site
POST /v1/sites/verify Verify domain ownership
POST /v1/sites/analyze Analyze for semantic matching
GET /v1/sites List your sites
GET /v1/discover Find matching sites
POST /v1/pool/contribute Offer link slots
POST /v1/pool/request Request links
GET /v1/pool/status Check credits & placements
GET /registry Public site list

🛡️ Anti-Pattern Rules

LinkSwarm enforces these to keep links Google-safe:

✓ No reciprocal within 90 days — If A→B exists, B→A is blocked
✓ Max 2 links per pair per year — Even non-reciprocal
✓ Semantic relevance required — Sites must share categories or content similarity
✓ Natural velocity — Max 1-2 links per site per week
✓ Contextual placement only — Links in content, not footers/sidebars

📚 Resources

🤖 Agent Integration Guide

Step-by-step for AI agents

📋 Protocol Spec

Full protocol documentation

📄 llms.txt

Quick reference for LLMs

❓ FAQ

Common questions answered